ansimax 1.3.6 → 1.4.0

package/dist/index.js

@@ -61,6 +61,8 @@ __export(index_exports, {
   charWidth: () => charWidth,
   clamp: () => clamp,
   clampByte: () => clampByte2,
+  clampInt: () => clampInt,
+  clampPercent: () => clampPercent,
   clearAnsiCache: () => clearAnsiCache,
   clearColorCache: () => clearColorCache,
   clearLine: () => clearLine,
@@ -125,6 +127,7 @@ __export(index_exports, {
   listPresets: () => listPresets,
   loader: () => loader,
   mapTree: () => mapTree,
+  markdown: () => markdown,
   measureBlock: () => measureBlock,
   measureTree: () => measureTree,
   memoize: () => memoize,
@@ -140,6 +143,8 @@ __export(index_exports, {
   padStart: () => padStart,
   panels: () => panels,
   parseFiglet: () => parseFiglet,
+  parseMarkdownBlocks: () => parseBlocks,
+  parseMarkdownInline: () => parseInline,
   pauseListeners: () => pauseListeners,
   presetNames: () => presetNames,
   presets: () => presets,
@@ -147,6 +152,7 @@ __export(index_exports, {
   rainbow: () => rainbow,
   registerFont: () => registerFont,
   registerPreset: () => registerPreset,
+  renderMarkdown: () => render,
   renderPixelArt: () => renderPixelArt,
   renderTree: () => renderTree,
   renderTreeStream: () => renderTreeStream,
@@ -608,6 +614,16 @@ var safeInt = (value, fallback = 0, min = -Infinity, max = Infinity) => {
 var clamp = (n, min, max) => Math.min(Math.max(n, min), max);
 var lerp = (a, b, t) => a + (b - a) * t;
 var clampByte2 = (v) => clamp(Math.round(v), 0, 255);
+var clampPercent = (p) => {
+  if (!isFiniteNumber2(p)) return 0;
+  return Math.max(0, Math.min(100, p));
+};
+var clampInt = (value, min, max, fallback = 0) => {
+  if (!isFiniteNumber2(value)) {
+    return Math.max(min, Math.min(max, Math.floor(fallback)));
+  }
+  return Math.max(min, Math.min(max, Math.floor(value)));
+};
 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) => {
@@ -3242,16 +3258,11 @@ var ascii = {
 
 // src/loaders/index.ts
 var canAnimate2 = () => Boolean(process.stdout?.isTTY) && supportsColor() !== "none";
-var isFiniteNumber3 = (n) => typeof n === "number" && Number.isFinite(n);
 var ensureString3 = (v) => typeof v === "string" ? v : String(v ?? "");
 var clampPositiveInt = (n, fallback) => {
-  if (!isFiniteNumber3(n)) return fallback;
+  if (!isFiniteNumber2(n)) return fallback;
   return Math.max(1, Math.floor(n));
 };
-var clampPercent = (p) => {
-  if (!isFiniteNumber3(p)) return 0;
-  return Math.max(0, Math.min(100, p));
-};
 var isUnicodeCapable = () => {
   const env = process.env;
   if (env["CI"]) return true;
@@ -3393,7 +3404,7 @@ var spin = (text = "Loading", opts = {}) => {
   const animInterval = Math.max(FRAME_MS, safeInterval);
   acquireCursor();
   const startTime = Date.now();
-  const render = () => {
+  const render2 = () => {
     if (stopped) return;
     const elapsed = Date.now() - startTime;
     frame2 = Math.floor(elapsed / animInterval) % frames2.length;
@@ -3403,8 +3414,8 @@ var spin = (text = "Loading", opts = {}) => {
     const buf = createOutputBuffer().push("\r").push(screen.clearLine()).push(line).toString();
     write(buf);
   };
-  render();
-  timer = setInterval(render, animInterval);
+  render2();
+  timer = setInterval(render2, animInterval);
   let abortedBySignal = false;
   const onAbort = () => {
     abortedBySignal = true;
@@ -3575,15 +3586,15 @@ var dots = (text = "Processing", opts = {}) => {
   let count = 0;
   let stopped = false;
   let timer = null;
-  const render = () => {
+  const render2 = () => {
     if (stopped) return;
     const dotStr = ".".repeat(count);
     const colored = applyColor(dotStr, hex);
     write("\r" + screen.clearLine() + text + colored);
     count = (count + 1) % (max + 1);
   };
-  render();
-  timer = setInterval(render, Math.max(FRAME_MS, interval));
+  render2();
+  timer = setInterval(render2, Math.max(FRAME_MS, interval));
   const onAbort = () => stopFn();
   if (signal) signal.addEventListener("abort", onAbort, { once: true });
   const stopFn = () => {
@@ -3615,15 +3626,15 @@ var custom = (frames2, text = "", opts = {}) => {
   let timer = null;
   const safeInterval = Math.max(FRAME_MS, interval);
   const startTime = Date.now();
-  const render = () => {
+  const render2 = () => {
     if (stopped) return;
     const elapsed = Date.now() - startTime;
     frame2 = Math.floor(elapsed / safeInterval) % frames2.length;
     const f = frames2[frame2] ?? "";
     write("\r" + screen.clearLine() + applyColor(f, hex) + " " + text);
   };
-  render();
-  timer = setInterval(render, safeInterval);
+  render2();
+  timer = setInterval(render2, safeInterval);
   const onAbort = () => stopFn();
   if (signal) signal.addEventListener("abort", onAbort, { once: true });
   const stopFn = () => {
@@ -3641,7 +3652,7 @@ var custom = (frames2, text = "", opts = {}) => {
 };
 var countdown = async (seconds, opts = {}) => {
   const { label = "Starting in", color: hex, signal } = opts;
-  const safeSeconds = isFiniteNumber3(seconds) ? Math.max(0, Math.floor(seconds)) : 0;
+  const safeSeconds = isFiniteNumber2(seconds) ? Math.max(0, Math.floor(seconds)) : 0;
   const safeLabel = ensureString3(label);
   const colorToUse = safeColor(hex) ? hex : "#ffd700";
   if (!canAnimate2() || signal?.aborted) {
@@ -3730,7 +3741,7 @@ var multi = (opts = {}) => {
   let frame2 = 0;
   let timer = null;
   let lastLineCount = 0;
-  const render = () => {
+  const render2 = () => {
     if (lastLineCount > 0) {
       write("\r" + cursor.up(lastLineCount) + screen.clearDown());
     }
@@ -3752,8 +3763,8 @@ var multi = (opts = {}) => {
   const start = () => {
     if (timer) return;
     acquireCursor();
-    render();
-    timer = setInterval(render, interval);
+    render2();
+    timer = setInterval(render2, interval);
   };
   const tick = () => {
     if (!timer) start();
@@ -3777,35 +3788,35 @@ var multi = (opts = {}) => {
         },
         set text(v) {
           item.text = v;
-          render();
+          render2();
         },
         update(newText) {
           item.text = newText;
-          render();
+          render2();
         },
         succeed(t) {
           item.state = "success";
           if (t !== void 0) item.finalText = t;
-          render();
+          render2();
           setTimeout(() => {
             items.delete(id);
-            render();
+            render2();
             checkEmpty();
           }, interval);
         },
         fail(t) {
           item.state = "fail";
           if (t !== void 0) item.finalText = t;
-          render();
+          render2();
           setTimeout(() => {
             items.delete(id);
-            render();
+            render2();
             checkEmpty();
           }, interval);
         },
         stop() {
           items.delete(id);
-          render();
+          render2();
           checkEmpty();
         }
       };
@@ -3849,11 +3860,10 @@ var loader = {
 };
 
 // src/frames/index.ts
-var isFiniteNumber4 = (n) => typeof n === "number" && Number.isFinite(n);
 var ensureString4 = (v) => typeof v === "string" ? v : String(v ?? "");
 var MAX_FPS = 60;
 var clampFps = (fps, fallback) => {
-  if (!isFiniteNumber4(fps)) return fallback;
+  if (!isFiniteNumber2(fps)) return fallback;
   return Math.max(1, Math.min(MAX_FPS, Math.floor(fps)));
 };
 var _cursorHiddenCount2 = 0;
@@ -3952,14 +3962,14 @@ var play = (frames2, opts = {}) => {
   if (fps !== void 0) {
     const safeFps = clampFps(fps, 60);
     tickMs = Math.max(FRAME_MS, Math.floor(1e3 / safeFps));
-  } else if (isFiniteNumber4(interval)) {
+  } else if (isFiniteNumber2(interval)) {
     tickMs = Math.max(FRAME_MS, Math.floor(interval));
   } else {
     tickMs = 100;
   }
   let safeRepeat;
   let infinite;
-  if (!isFiniteNumber4(repeat)) {
+  if (!isFiniteNumber2(repeat)) {
     safeRepeat = 1;
     infinite = false;
   } else if (repeat === 0) {
@@ -4084,7 +4094,7 @@ var play = (frames2, opts = {}) => {
       paused = false;
     },
     seek: (idx) => {
-      if (!isFiniteNumber4(idx)) return;
+      if (!isFiniteNumber2(idx)) return;
       const safe = Math.max(0, Math.floor(idx));
       frameIdx = frames2.length > 0 ? safe % frames2.length : 0;
     },
@@ -4097,7 +4107,7 @@ var play = (frames2, opts = {}) => {
   };
 };
 var generate = (count, fn) => {
-  const safeCount = isFiniteNumber4(count) ? Math.max(0, Math.floor(count)) : 0;
+  const safeCount = isFiniteNumber2(count) ? Math.max(0, Math.floor(count)) : 0;
   if (typeof fn !== "function") return Array(safeCount).fill("");
   return Array.from({ length: safeCount }, (_, i) => {
     try {
@@ -4116,7 +4126,7 @@ var live = (opts = {}) => {
   let running = false;
   let timer = null;
   let abortHandler = null;
-  const render = () => {
+  const render2 = () => {
     if (lastLines > 0) clearLines(lastLines);
     const frame2 = isColorless2() ? stripAnsi(currentFrame) : currentFrame;
     try {
@@ -4131,7 +4141,7 @@ var live = (opts = {}) => {
     running = true;
     registerCrashHandlers3();
     hideCursorSafe2();
-    timer = setInterval(render, interval);
+    timer = setInterval(render2, interval);
     if (signal && !abortHandler) {
       abortHandler = () => stop({ clear: false });
       if (signal.aborted) abortHandler();
@@ -4160,7 +4170,7 @@ var live = (opts = {}) => {
   };
   const update = (newFrame) => {
     currentFrame = ensureString4(newFrame);
-    if (running) render();
+    if (running) render2();
   };
   if (autoStart) start();
   return { start, stop, update, isRunning: () => running };
@@ -4169,7 +4179,7 @@ var morph = (frameA, frameB, steps = 8, charset = "\u2591\u2592\u2593\u2588\u259
   const a0 = ensureString4(frameA);
   const b0 = ensureString4(frameB);
   if (!a0 && !b0) return [""];
-  const n = Math.max(2, isFiniteNumber4(steps) ? Math.floor(steps) : 8);
+  const n = Math.max(2, isFiniteNumber2(steps) ? Math.floor(steps) : 8);
   const len = Math.max(a0.length, b0.length);
   const a = a0.padEnd(len);
   const b = b0.padEnd(len);
@@ -4191,7 +4201,7 @@ var morph = (frameA, frameB, steps = 8, charset = "\u2591\u2592\u2593\u2588\u259
 var presets2 = {
   loadingBar: (opts = {}) => {
     const { width = 20, char = "\u2588", empty = "\u2591", label = "Loading" } = opts;
-    const safeWidth = Math.max(0, isFiniteNumber4(width) ? Math.floor(width) : 20);
+    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);
@@ -4205,7 +4215,7 @@ var presets2 = {
   /* istanbul ignore next — default opts {} */
   ball: (opts = {}) => {
     const { width = 20, char = "\u25CF" } = opts;
-    const safeWidth = Math.max(1, isFiniteNumber4(width) ? Math.floor(width) : 20);
+    const safeWidth = Math.max(1, isFiniteNumber2(width) ? Math.floor(width) : 20);
     const safeChar = typeof char === "string" && char.length > 0 ? char : "\u25CF";
     const forward = generate(safeWidth, (i) => " ".repeat(i) + safeChar);
     const backward = generate(safeWidth, (i) => " ".repeat(safeWidth - i - 1) + safeChar);
@@ -4215,7 +4225,7 @@ var presets2 = {
   breathe: (text, opts = {}) => {
     const { steps = 8 } = opts;
     const safeText = ensureString4(text);
-    const safeSteps2 = Math.max(1, isFiniteNumber4(steps) ? Math.floor(steps) : 8);
+    const safeSteps2 = Math.max(1, isFiniteNumber2(steps) ? Math.floor(steps) : 8);
     const shades = ["\u2591", "\u2592", "\u2593", "\u2588"];
     return generate(safeSteps2 * 2, (i) => {
       const t = i < safeSteps2 ? i / safeSteps2 : 1 - (i - safeSteps2) / safeSteps2;
@@ -4236,22 +4246,17 @@ var presets2 = {
 var frames = { play, generate, live, morph, presets: presets2 };
 
 // src/components/index.ts
-var isFiniteNumber5 = (n) => typeof n === "number" && Number.isFinite(n);
 var ensureString5 = (v) => typeof v === "string" ? v : String(v ?? "");
-var clampPercent2 = (p) => {
-  if (!isFiniteNumber5(p)) return 0;
-  return Math.max(0, Math.min(100, p));
-};
 var clampNonNeg = (n, fallback) => {
-  if (!isFiniteNumber5(n)) return fallback;
+  if (!isFiniteNumber2(n)) return fallback;
   return Math.max(0, Math.floor(n));
 };
 var clampPositive2 = (n, fallback) => {
-  if (!isFiniteNumber5(n)) return fallback;
+  if (!isFiniteNumber2(n)) return fallback;
   return Math.max(1, Math.floor(n));
 };
 var safeSgrCode = (code, fallback) => {
-  if (!isFiniteNumber5(code)) return fallback;
+  if (!isFiniteNumber2(code)) return fallback;
   return Math.max(0, Math.min(255, Math.floor(code)));
 };
 var truncateVisible = (str, maxWidth, ellipsis = "\u2026") => {
@@ -4289,7 +4294,7 @@ var table = (rows, opts = {}) => {
   const b = TABLE_BORDERS[borderStyle] ?? TABLE_BORDERS.rounded;
   const safePadding = clampNonNeg(padding, 1);
   const pad = " ".repeat(safePadding);
-  const safeMaxCol = maxColWidth !== null && isFiniteNumber5(maxColWidth) ? Math.max(1, Math.floor(maxColWidth)) : null;
+  const safeMaxCol = maxColWidth !== null && isFiniteNumber2(maxColWidth) ? Math.max(1, Math.floor(maxColWidth)) : null;
   const validRows = rows.filter((r) => Array.isArray(r));
   if (validRows.length === 0) return "";
   const cols = Math.max(...validRows.map((r) => r.length), 0);
@@ -4376,13 +4381,13 @@ var progressBar = (percent, opts = {}) => {
   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 clamped = clampPercent2(percent);
+  const clamped = clampPercent(percent);
   const filled = Math.floor(clamped / 100 * safeWidth);
   const empty = Math.max(0, safeWidth - filled);
   let filledStr = safeChar.repeat(filled);
   if (Array.isArray(gradientStops2) && gradientStops2.length >= 1 && filled > 0) {
     filledStr = gradient(filledStr, gradientStops2);
-  } else if (color2 !== null && isFiniteNumber5(color2)) {
+  } else if (color2 !== null && isFiniteNumber2(color2)) {
     filledStr = sgr(safeSgrCode(color2, FG.white)) + filledStr + reset();
   }
   const emptyStr = safeEmpty.repeat(empty);
@@ -4418,7 +4423,7 @@ var section = (title, opts = {}) => {
   const safeChar = typeof char === "string" && char.length > 0 ? char : "\u2500";
   const safeColor2 = safeSgrCode(colorCode, FG.cyan);
   const titleLen = visibleLen(safeTitle);
-  const requestedWidth = width !== null && isFiniteNumber5(width) ? Math.max(1, Math.floor(width)) : cols;
+  const requestedWidth = width !== null && isFiniteNumber2(width) ? Math.max(1, Math.floor(width)) : cols;
   const w = Math.max(requestedWidth, titleLen + 2);
   const side = Math.floor((w - titleLen - 2) / 2);
   const dividerL = sgr(safeColor2) + safeChar.repeat(Math.max(0, side)) + reset();
@@ -4432,7 +4437,7 @@ var columns = (items, opts = {}) => {
   const safeCols = clampPositive2(numCols, 2);
   const safeGap = clampNonNeg(gap, 2);
   const { cols: termCols } = termSize();
-  const totalW = width !== null && isFiniteNumber5(width) ? Math.max(safeCols, Math.floor(width)) : termCols;
+  const totalW = width !== null && isFiniteNumber2(width) ? Math.max(safeCols, Math.floor(width)) : termCols;
   const colW = Math.max(1, Math.floor((totalW - safeGap * (safeCols - 1)) / safeCols));
   const gapStr = " ".repeat(safeGap);
   const rows = [];
@@ -4472,7 +4477,7 @@ 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 && isFiniteNumber5(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(ensureString5(e.time)) : 0));
   const lines = [];
   events.forEach((ev, i) => {
     const isLast = i === events.length - 1;
@@ -4514,7 +4519,7 @@ var menu = (items, opts = {}) => {
     } catch {
     }
   };
-  const render = () => {
+  const render2 = () => {
     let totalLines = 0;
     const { cols: termCols } = termSize();
     const safeTermCols = Math.max(1, termCols);
@@ -4588,7 +4593,7 @@ var menu = (items, opts = {}) => {
   try {
     emit(cursor.hide());
     cursorHidden = true;
-    lastRenderedLines = render();
+    lastRenderedLines = render2();
   } catch {
     cleanup(null);
     return Promise.resolve(MENU_CANCELLED);
@@ -4629,7 +4634,7 @@ var menu = (items, opts = {}) => {
           return;
         }
         clearLinesLocal();
-        lastRenderedLines = render();
+        lastRenderedLines = render2();
       } catch {
         cleanup(onKey);
         safeResolve(MENU_CANCELLED);
@@ -4664,10 +4669,9 @@ var STYLES = {
   heavy: { branch: "\u2523\u2501\u2501 ", last: "\u2517\u2501\u2501 ", vert: "\u2503   ", space: "    " },
   ascii: { branch: "+-- ", last: "`-- ", vert: "|   ", space: "    " }
 };
-var isFiniteNumber6 = (n) => typeof n === "number" && Number.isFinite(n);
 var ensureString6 = (v) => typeof v === "string" ? v : String(v ?? "");
 var clampNonNeg2 = (n, fallback) => {
-  if (!isFiniteNumber6(n)) return 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");
@@ -4739,7 +4743,7 @@ var renderChildren = (children, parentContinuation, lines, indentStr, defaultSty
   if (!Array.isArray(children)) return;
   let visible = children;
   let collapsedCount = 0;
-  const safeCollapse = isFiniteNumber6(collapse) ? Math.floor(collapse) : 0;
+  const safeCollapse = isFiniteNumber2(collapse) ? Math.floor(collapse) : 0;
   if (safeCollapse > 0 && safeCollapse < children.length) {
     visible = children.slice(safeCollapse);
     collapsedCount = safeCollapse;
@@ -4809,7 +4813,7 @@ var renderTree = (root, opts = {}) => {
   } = opts;
   const safeStyle = style && STYLES[style] ? style : "normal";
   const safeIndent = clampNonNeg2(indent, 0);
-  const safeMaxDepth = isFiniteNumber6(maxDepth) ? Math.max(0, Math.floor(maxDepth)) : Infinity;
+  const safeMaxDepth = isFiniteNumber2(maxDepth) ? Math.max(0, Math.floor(maxDepth)) : Infinity;
   const indentStr = " ".repeat(safeIndent);
   const lines = [];
   const rootLabel = formatNode(root, 0, palette);
@@ -5428,13 +5432,8 @@ var themes = {
 var FULL_BLOCK = "\u2588";
 var UPPER_HALF = "\u2580";
 var LOWER_HALF = "\u2584";
-var isFiniteNumber7 = (n) => typeof n === "number" && Number.isFinite(n);
-var clampInt = (n, min, max, fallback) => {
-  if (!isFiniteNumber7(n)) return fallback;
-  return Math.max(min, Math.min(max, Math.floor(n)));
-};
 var clampByte3 = (n) => {
-  if (!isFiniteNumber7(n)) return 0;
+  if (!isFiniteNumber2(n)) return 0;
   return Math.max(0, Math.min(255, Math.round(n)));
 };
 var MAX_DIMENSION = 1e4;
@@ -5739,7 +5738,7 @@ var gradientRect = (opts = {}) => {
   const safeW = clampInt(width, 2, MAX_DIMENSION, 40);
   const safeH = clampInt(height, 2, MAX_DIMENSION, 10);
   let cosA = 1, sinA = 0;
-  if (isFiniteNumber7(angle)) {
+  if (isFiniteNumber2(angle)) {
     const rad = angle * Math.PI / 180;
     cosA = Math.cos(rad);
     sinA = Math.sin(rad);
@@ -5749,7 +5748,7 @@ var gradientRect = (opts = {}) => {
     const line = [];
     for (let col = 0; col < safeW; col++) {
       let t;
-      if (isFiniteNumber7(angle)) {
+      if (isFiniteNumber2(angle)) {
         const projection = col / (safeW - 1) * cosA + row / (safeH - 1) * sinA;
         t = clamp((projection + 1) / 2, 0, 1);
       } else if (style === "horizontal") t = col / (safeW - 1);
@@ -5806,7 +5805,7 @@ var createCanvas = (width, height, fillColor = null) => {
     if (y > dirtyMaxY) dirtyMaxY = y;
   };
   const setInternal = (x, y, color2) => {
-    if (!isFiniteNumber7(x) || !isFiniteNumber7(y)) return;
+    if (!isFiniteNumber2(x) || !isFiniteNumber2(y)) return;
     const ix = Math.floor(x);
     const iy = Math.floor(y);
     if (iy < 0 || iy >= h || ix < 0 || ix >= w) return;
@@ -5821,7 +5820,7 @@ var createCanvas = (width, height, fillColor = null) => {
     },
     set: setInternal,
     get(x, y) {
-      if (!isFiniteNumber7(x) || !isFiniteNumber7(y)) return null;
+      if (!isFiniteNumber2(x) || !isFiniteNumber2(y)) return null;
       const ix = Math.floor(x), iy = Math.floor(y);
       return cloneColor(pixels[iy]?.[ix] ?? null);
     },
@@ -5837,7 +5836,7 @@ var createCanvas = (width, height, fillColor = null) => {
       dirtyMaxY = h - 1;
     },
     drawRect(x, y, rw, rh, color2, fill = false) {
-      if (!isFiniteNumber7(x) || !isFiniteNumber7(y) || !isFiniteNumber7(rw) || !isFiniteNumber7(rh)) return;
+      if (!isFiniteNumber2(x) || !isFiniteNumber2(y) || !isFiniteNumber2(rw) || !isFiniteNumber2(rh)) return;
       if (rw <= 0 || rh <= 0) return;
       const ix = Math.floor(x);
       const iy = Math.floor(y);
@@ -5859,7 +5858,7 @@ var createCanvas = (width, height, fillColor = null) => {
       }
     },
     drawCircle(cx, cy, radius, color2, fill = false) {
-      if (!isFiniteNumber7(cx) || !isFiniteNumber7(cy) || !isFiniteNumber7(radius)) return;
+      if (!isFiniteNumber2(cx) || !isFiniteNumber2(cy) || !isFiniteNumber2(radius)) return;
       if (radius <= 0) return;
       const x0 = Math.max(0, Math.floor(cx - radius - 1));
       const y0 = Math.max(0, Math.floor(cy - radius - 1));
@@ -5882,7 +5881,7 @@ var createCanvas = (width, height, fillColor = null) => {
       }
     },
     drawSprite(x, y, sprite) {
-      if (!isFiniteNumber7(x) || !isFiniteNumber7(y)) return;
+      if (!isFiniteNumber2(x) || !isFiniteNumber2(y)) return;
       if (!Array.isArray(sprite)) return;
       const sx = Math.floor(x);
       const sy = Math.floor(y);
@@ -6347,8 +6346,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 visibleLen2 = candidate.replace(/\x1b\[[0-9;]*m/g, "").length;
-        if (visibleLen2 <= inlineArrayMaxLength) {
+        const visibleLen3 = candidate.replace(/\x1b\[[0-9;]*m/g, "").length;
+        if (visibleLen3 <= inlineArrayMaxLength) {
           return candidate;
         }
       }
@@ -6427,6 +6426,269 @@ 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") : "";
+var HEADING_RE = /^(#{1,6})\s+(.+?)\s*#*\s*$/;
+var ORDERED_LIST_RE = /^(\s*)(\d+)[.)]\s+(.+)$/;
+var UNORDERED_LIST_RE = /^(\s*)[-*+]\s+(.+)$/;
+var HR_RE = /^[ \t]*(?:-{3,}|\*{3,}|_{3,})[ \t]*$/;
+var CODEBLOCK_OPEN_RE = /^```[ \t]*(\S*)[ \t]*$/;
+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 parseBlocks = (source) => {
+  if (typeof source !== "string" || source.length === 0) return [];
+  const lines = _normalize(source).split("\n");
+  const out = [];
+  let i = 0;
+  while (i < lines.length) {
+    const line = lines[i];
+    if (line.trim() === "") {
+      out.push({ type: "blank" });
+      i++;
+      continue;
+    }
+    if (HR_RE.test(line)) {
+      out.push({ type: "hr" });
+      i++;
+      continue;
+    }
+    const headingMatch = HEADING_RE.exec(line);
+    if (headingMatch) {
+      const level = headingMatch[1].length;
+      const text = headingMatch[2].trim();
+      out.push({ type: "heading", level, text });
+      i++;
+      continue;
+    }
+    const codeOpen = CODEBLOCK_OPEN_RE.exec(line);
+    if (codeOpen) {
+      const lang = codeOpen[1].trim();
+      const codeLines = [];
+      i++;
+      while (i < lines.length && !CODEBLOCK_CLOSE_RE.test(lines[i])) {
+        codeLines.push(lines[i]);
+        i++;
+      }
+      if (i < lines.length) i++;
+      out.push({ type: "codeblock", lang, code: codeLines.join("\n") });
+      continue;
+    }
+    if (BLOCKQUOTE_RE.test(line)) {
+      const qLines = [];
+      while (i < lines.length && BLOCKQUOTE_RE.test(lines[i])) {
+        const m = BLOCKQUOTE_RE.exec(lines[i]);
+        qLines.push((m?.[1] ?? "").trim());
+        i++;
+      }
+      out.push({ type: "blockquote", text: qLines.join("\n") });
+      continue;
+    }
+    if (TABLE_ROW_RE.test(line) && i + 1 < lines.length && TABLE_SEPARATOR_RE.test(lines[i + 1])) {
+      const headers = _splitTableRow(line);
+      i += 2;
+      const rows = [];
+      while (i < lines.length && TABLE_ROW_RE.test(lines[i])) {
+        rows.push(_splitTableRow(lines[i]));
+        i++;
+      }
+      out.push({ type: "table", headers, rows });
+      continue;
+    }
+    const ulMatch = UNORDERED_LIST_RE.exec(line);
+    const olMatch = ORDERED_LIST_RE.exec(line);
+    if (ulMatch || olMatch) {
+      const ordered = olMatch != null;
+      const items = [];
+      while (i < lines.length) {
+        const ln = lines[i];
+        const u = UNORDERED_LIST_RE.exec(ln);
+        const o = ORDERED_LIST_RE.exec(ln);
+        if (ordered && o) {
+          items.push(o[3].trim());
+          i++;
+        } else if (!ordered && u) {
+          items.push(u[2].trim());
+          i++;
+        } else {
+          break;
+        }
+      }
+      out.push({ type: "list", ordered, items });
+      continue;
+    }
+    const paraLines = [line];
+    i++;
+    while (i < lines.length) {
+      const next = lines[i];
+      if (next.trim() === "" || HEADING_RE.test(next) || HR_RE.test(next) || CODEBLOCK_OPEN_RE.test(next) || BLOCKQUOTE_RE.test(next) || UNORDERED_LIST_RE.test(next) || ORDERED_LIST_RE.test(next) || TABLE_ROW_RE.test(next)) {
+        break;
+      }
+      paraLines.push(next);
+      i++;
+    }
+    out.push({ type: "paragraph", text: paraLines.join(" ").trim() });
+  }
+  return out;
+};
+var _splitTableRow = (row) => {
+  const stripped = row.trim().replace(/^\|/, "").replace(/\|[ \t]*$/, "");
+  return stripped.split("|").map((c) => c.trim());
+};
+var parseInline = (text, opts = {
+  theme: "dark",
+  inlineCodeBackground: true
+}) => {
+  if (typeof text !== "string" || text.length === 0) return "";
+  const t = THEMES[opts.theme];
+  const codeSlots = [];
+  let s = text.replace(/`([^`\n]+)`/g, (_m, code) => {
+    const styled = opts.inlineCodeBackground ? color.dim(color.hex(t.code)("\xA0" + code + "\xA0")) : color.dim(color.hex(t.code)(code));
+    codeSlots.push(styled);
+    return `\0CODE${codeSlots.length - 1}\0`;
+  });
+  s = s.replace(/\[([^\]]+)\]\(([^)\s]+)\)/g, (_m, label, url) => {
+    return hyperlink(url, color.hex(t.link)(color.underline(label)));
+  });
+  s = s.replace(/~~([^~\n]+)~~/g, (_m, inner) => color.strikethrough(inner));
+  s = s.replace(/\*\*([^*\n]+)\*\*/g, (_m, inner) => color.bold(inner));
+  s = s.replace(/__([^_\n]+)__/g, (_m, inner) => color.bold(inner));
+  s = s.replace(/(^|[^*])\*([^*\n]+)\*(?!\*)/g, (_m, pre, inner) => pre + color.italic(inner));
+  s = s.replace(/(^|[^_])_([^_\n]+)_(?!_)/g, (_m, pre, inner) => pre + color.italic(inner));
+  s = s.replace(/\x00CODE(\d+)\x00/g, (_m, idx) => codeSlots[Number(idx)] ?? "");
+  return s;
+};
+var _detectWidth = () => {
+  const w = process.stdout?.columns;
+  return isFiniteNumber2(w) && w > 10 ? w : 80;
+};
+var render = (source, opts = {}) => {
+  if (typeof source !== "string" || source.length === 0) return "";
+  const {
+    width = _detectWidth(),
+    theme = "dark",
+    headingGradient,
+    boxCodeBlocks = true,
+    inlineCodeBackground = true
+  } = opts;
+  const safeWidth = isFiniteNumber2(width) && width > 4 ? Math.floor(width) : 80;
+  const t = THEMES[theme] ?? THEMES.dark;
+  const h1Colors = headingGradient && headingGradient.length >= 2 ? headingGradient : t.h1;
+  const blocks = parseBlocks(source);
+  const inlineOpts = { theme, inlineCodeBackground };
+  const out = [];
+  for (const block of blocks) {
+    switch (block.type) {
+      case "blank":
+        out.push("");
+        break;
+      case "hr":
+        out.push(color.hex(t.hr)(ascii.divider({ width: safeWidth, char: "\u2500" })));
+        break;
+      case "heading": {
+        const inline = parseInline(block.text, inlineOpts);
+        if (block.level === 1) {
+          out.push(color.bold(gradient(inline, h1Colors)));
+        } else if (block.level === 2) {
+          out.push(color.bold(color.underline(color.hex(t.h2)(inline))));
+        } else {
+          const colorKey = `h${block.level}`;
+          const hex = t[colorKey];
+          out.push(color.bold(color.hex(hex)(inline)));
+        }
+        break;
+      }
+      case "paragraph": {
+        out.push(parseInline(block.text, inlineOpts));
+        break;
+      }
+      case "codeblock": {
+        const codeText = block.code.length > 0 ? block.code : " ";
+        if (boxCodeBlocks) {
+          const labeled = block.lang ? ` ${block.lang} ` : null;
+          const box3 = ascii.box(codeText, {
+            borderStyle: "rounded",
+            padding: 1,
+            title: labeled
+          });
+          out.push(color.hex(t.codeBlockBorder)(box3));
+        } else {
+          const indented = codeText.split("\n").map((l) => "    " + l).join("\n");
+          out.push(color.dim(indented));
+        }
+        break;
+      }
+      case "list": {
+        const lines = [];
+        for (let idx = 0; idx < block.items.length; idx++) {
+          const marker = block.ordered ? `${idx + 1}.` : "\u2022";
+          const rendered = parseInline(block.items[idx], inlineOpts);
+          lines.push(`  ${color.hex(t.h3)(marker)} ${rendered}`);
+        }
+        out.push(lines.join("\n"));
+        break;
+      }
+      case "blockquote": {
+        const rendered = parseInline(block.text, inlineOpts);
+        const quoted = rendered.split("\n").map((l) => color.hex(t.blockquote)("\u2502 ") + color.dim(l)).join("\n");
+        out.push(quoted);
+        break;
+      }
+      case "table": {
+        const styledHeaders = block.headers.map(
+          (h) => color.bold(color.hex(t.tableHeader)(parseInline(h, inlineOpts)))
+        );
+        const styledRows = block.rows.map(
+          (row) => row.map((cell) => parseInline(cell, inlineOpts))
+        );
+        out.push(components.table([styledHeaders, ...styledRows], {
+          borderStyle: "rounded",
+          padding: 1
+        }));
+        break;
+      }
+    }
+  }
+  while (out.length > 0 && out[out.length - 1] === "") out.pop();
+  return out.join("\n");
+};
+var markdown = {
+  render,
+  parseBlocks,
+  parseInline
+};
+
 // src/configure.ts
 var DEFAULTS = Object.freeze({
   colorMode: "auto",
@@ -6734,7 +6996,23 @@ var resolveEasingByName = (e) => {
 };
 
 // src/index.ts
-var ansimax = { color, animate, ascii, loader, frames, components, trees, themes, images, configure };
+var ansimax = {
+  color,
+  animate,
+  ascii,
+  loader,
+  frames,
+  components,
+  trees,
+  themes,
+  images,
+  configure,
+  // v1.3.0+
+  panels,
+  json,
+  // v1.4.0
+  markdown
+};
 var index_default = ansimax;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -6769,6 +7047,8 @@ var index_default = ansimax;
   charWidth,
   clamp,
   clampByte,
+  clampInt,
+  clampPercent,
   clearAnsiCache,
   clearColorCache,
   clearLine,
@@ -6832,6 +7112,7 @@ var index_default = ansimax;
   listPresets,
   loader,
   mapTree,
+  markdown,
   measureBlock,
   measureTree,
   memoize,
@@ -6847,6 +7128,8 @@ var index_default = ansimax;
   padStart,
   panels,
   parseFiglet,
+  parseMarkdownBlocks,
+  parseMarkdownInline,
   pauseListeners,
   presetNames,
   presets,
@@ -6854,6 +7137,7 @@ var index_default = ansimax;
   rainbow,
   registerFont,
   registerPreset,
+  renderMarkdown,
   renderPixelArt,
   renderTree,
   renderTreeStream,