ansimax 1.3.7 → 1.4.1

package/dist/index.mjs

@@ -3192,7 +3192,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;
@@ -3202,8 +3202,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;
@@ -3374,15 +3374,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 = () => {
@@ -3414,15 +3414,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 = () => {
@@ -3529,7 +3529,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());
     }
@@ -3551,8 +3551,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();
@@ -3576,35 +3576,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();
         }
       };
@@ -3914,7 +3914,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 {
@@ -3929,7 +3929,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();
@@ -3958,7 +3958,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 };
@@ -4307,7 +4307,7 @@ var menu = (items, opts = {}) => {
     } catch {
     }
   };
-  const render = () => {
+  const render2 = () => {
     let totalLines = 0;
     const { cols: termCols } = termSize();
     const safeTermCols = Math.max(1, termCols);
@@ -4381,7 +4381,7 @@ var menu = (items, opts = {}) => {
   try {
     emit(cursor.hide());
     cursorHidden = true;
-    lastRenderedLines = render();
+    lastRenderedLines = render2();
   } catch {
     cleanup(null);
     return Promise.resolve(MENU_CANCELLED);
@@ -4422,7 +4422,7 @@ var menu = (items, opts = {}) => {
           return;
         }
         clearLinesLocal();
-        lastRenderedLines = render();
+        lastRenderedLines = render2();
       } catch {
         cleanup(onKey);
         safeResolve(MENU_CANCELLED);
@@ -5946,37 +5946,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,
@@ -6214,6 +6282,274 @@ var json = {
   pretty
 };
 
+// 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+(.+)$/;
+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 _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");
+  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;
+};
+
+// 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"
+  }
+};
+
+// 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 = [];
+  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;
+};
+
+// src/markdown/renderer.ts
+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");
+};
+
+// src/markdown/index.ts
+var markdown = {
+  render,
+  parseBlocks,
+  parseInline
+};
+
 // src/configure.ts
 var DEFAULTS = Object.freeze({
   colorMode: "auto",
@@ -6521,7 +6857,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;
 export {
   ASCII_RAMPS,
@@ -6621,6 +6973,7 @@ export {
   listPresets,
   loader,
   mapTree,
+  markdown,
   measureBlock,
   measureTree,
   memoize,
@@ -6636,6 +6989,8 @@ export {
   padStart,
   panels,
   parseFiglet,
+  parseBlocks as parseMarkdownBlocks,
+  parseInline as parseMarkdownInline,
   pauseListeners,
   presetNames,
   presets,
@@ -6643,6 +6998,7 @@ export {
   rainbow,
   registerFont,
   registerPreset,
+  render as renderMarkdown,
   renderPixelArt,
   renderTree,
   renderTreeStream,

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

package/package.json

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