ansimax 1.2.8 → 1.3.1

package/dist/index.mjs

@@ -1162,13 +1162,13 @@ var animateGradient = (text, stops, opts = {}) => {
     const elapsed = Date.now() - startTime;
     let phase = elapsed / safeDuration2 % 1;
     if (direction === "reverse") phase = 1 - phase;
-    const frame = gradient(text, stops, { preserveAnsi, easing, phase });
+    const frame2 = gradient(text, stops, { preserveAnsi, easing, phase });
     if (onFrame) {
-      onFrame(frame, phase);
+      onFrame(frame2, phase);
     } else {
       try {
         if (process?.stdout?.write) {
-          process.stdout.write("\r" + frame);
+          process.stdout.write("\r" + frame2);
         }
       } catch {
       }
@@ -1458,9 +1458,9 @@ var safeWrite = (data) => {
   } catch {
   }
 };
-var fireFrame = (hooks, frame) => {
+var fireFrame = (hooks, frame2) => {
   try {
-    hooks?.onFrame?.(frame);
+    hooks?.onFrame?.(frame2);
   } catch {
   }
 };
@@ -1492,7 +1492,7 @@ var typewriter = async (text, opts = {}) => {
   registerCrashHandlers();
   hideCursorSafe();
   let aborted = false;
-  let frame = 0;
+  let frame2 = 0;
   try {
     for (const ch of text) {
       if (isAborted(signal)) {
@@ -1500,7 +1500,7 @@ var typewriter = async (text, opts = {}) => {
         break;
       }
       await safeWriteAsync(colorFn ? colorFn(ch) : ch);
-      fireFrame(hooks, frame++);
+      fireFrame(hooks, frame2++);
       await sleep(ch === " " ? speed * 0.3 : speed, { signal });
     }
   } finally {
@@ -1671,7 +1671,7 @@ var pulse = async (text, opts = {}) => {
   registerCrashHandlers();
   hideCursorSafe();
   let aborted = false;
-  let frame = 0;
+  let frame2 = 0;
   try {
     for (let t = 0; t < cycles; t++) {
       if (isAborted(signal)) {
@@ -1681,7 +1681,7 @@ var pulse = async (text, opts = {}) => {
       await safeWriteAsync(
         cursor.save() + fgRgb(c1.r, c1.g, c1.b) + text + reset() + cursor.restore()
       );
-      fireFrame(hooks, frame++);
+      fireFrame(hooks, frame2++);
       await sleep(halfInterval, { signal });
       if (isAborted(signal)) {
         aborted = true;
@@ -1690,7 +1690,7 @@ var pulse = async (text, opts = {}) => {
       await safeWriteAsync(
         cursor.save() + fgRgb(c2.r, c2.g, c2.b) + text + reset() + cursor.restore()
       );
-      fireFrame(hooks, frame++);
+      fireFrame(hooks, frame2++);
       await sleep(halfInterval, { signal });
     }
     if (!aborted) {
@@ -2835,7 +2835,7 @@ var spin = (text = "Loading", opts = {}) => {
       }
     };
   }
-  let frame = 0;
+  let frame2 = 0;
   let stopped = false;
   let timer = null;
   const animInterval = Math.max(FRAME_MS, safeInterval);
@@ -2844,8 +2844,8 @@ var spin = (text = "Loading", opts = {}) => {
   const render = () => {
     if (stopped) return;
     const elapsed = Date.now() - startTime;
-    frame = Math.floor(elapsed / animInterval) % frames2.length;
-    const f = frames2[frame] ?? "";
+    frame2 = Math.floor(elapsed / animInterval) % frames2.length;
+    const f = frames2[frame2] ?? "";
     const colored = applyColor(f, hex);
     const line = padToTerminalWidth(`${safePrefix}${colored} ${safeText}${safeSuffix}`);
     const buf = createOutputBuffer().push("\r").push(screen.clearLine()).push(line).toString();
@@ -3058,7 +3058,7 @@ var custom = (frames2, text = "", opts = {}) => {
   }
   registerCrashHandlers2();
   acquireCursor();
-  let frame = 0;
+  let frame2 = 0;
   let stopped = false;
   let timer = null;
   const safeInterval = Math.max(FRAME_MS, interval);
@@ -3066,8 +3066,8 @@ var custom = (frames2, text = "", opts = {}) => {
   const render = () => {
     if (stopped) return;
     const elapsed = Date.now() - startTime;
-    frame = Math.floor(elapsed / safeInterval) % frames2.length;
-    const f = frames2[frame] ?? "";
+    frame2 = Math.floor(elapsed / safeInterval) % frames2.length;
+    const f = frames2[frame2] ?? "";
     write("\r" + screen.clearLine() + applyColor(f, hex) + " " + text);
   };
   render();
@@ -3175,7 +3175,7 @@ var multi = (opts = {}) => {
   registerCrashHandlers2();
   let nextId = 0;
   const items = /* @__PURE__ */ new Map();
-  let frame = 0;
+  let frame2 = 0;
   let timer = null;
   let lastLineCount = 0;
   const render = () => {
@@ -3189,13 +3189,13 @@ var multi = (opts = {}) => {
       let glyph;
       if (item.state === "success") glyph = applyColor("\u2713", "#00ff88");
       else if (item.state === "fail") glyph = applyColor("\u2717", "#ff6b6b");
-      else glyph = applyColor(frames2[frame % frames2.length] ?? "", item.color ?? null);
+      else glyph = applyColor(frames2[frame2 % frames2.length] ?? "", item.color ?? null);
       const text = item.finalText ?? item.text;
       buf.pushln(padToTerminalWidth(`${glyph} ${text}`));
     }
     write(buf.toString());
     lastLineCount = itemsArr.length;
-    frame++;
+    frame2++;
   };
   const start = () => {
     if (timer) return;
@@ -3356,9 +3356,9 @@ var registerCrashHandlers3 = () => {
   if (isTestEnv3()) return;
   installCrashHandlersImpl3();
 };
-var lineCount = (frame) => {
-  if (typeof frame !== "string" || frame.length === 0) return 0;
-  const normalized = frame.replace(/\r\n/g, "\n").replace(/\r/g, "");
+var lineCount = (frame2) => {
+  if (typeof frame2 !== "string" || frame2.length === 0) return 0;
+  const normalized = frame2.replace(/\r\n/g, "\n").replace(/\r/g, "");
   return normalized.split("\n").length;
 };
 var clearLines = (n) => {
@@ -3369,7 +3369,7 @@ var clearLines = (n) => {
   }
 };
 var isColorless2 = () => supportsColor() === "none";
-var defaultOnFrame = (frame) => isColorless2() ? stripAnsi(frame) : frame;
+var defaultOnFrame = (frame2) => isColorless2() ? stripAnsi(frame2) : frame2;
 var play = (frames2, opts = {}) => {
   if (!Array.isArray(frames2)) {
     const resolved = Promise.resolve();
@@ -3430,13 +3430,13 @@ var play = (frames2, opts = {}) => {
   const done = new Promise((r) => {
     resolveDone = r;
   });
-  const renderFrame = (frame, idx) => {
+  const renderFrame = (frame2, idx) => {
     if (lastLines > 0) clearLines(lastLines);
     let rendered;
     try {
-      rendered = userOnFrame(frame, idx);
+      rendered = userOnFrame(frame2, idx);
     } catch {
-      rendered = frame;
+      rendered = frame2;
     }
     const safe = ensureString4(rendered);
     try {
@@ -3565,13 +3565,13 @@ var live = (opts = {}) => {
   let abortHandler = null;
   const render = () => {
     if (lastLines > 0) clearLines(lastLines);
-    const frame = isColorless2() ? stripAnsi(currentFrame) : currentFrame;
+    const frame2 = isColorless2() ? stripAnsi(currentFrame) : currentFrame;
     try {
-      write(frame);
+      write(frame2);
     } catch {
     }
-    lastLines = lineCount(frame);
-    if (!frame.endsWith("\n")) writeln();
+    lastLines = lineCount(frame2);
+    if (!frame2.endsWith("\n")) writeln();
   };
   const start = () => {
     if (running) return;
@@ -5428,6 +5428,335 @@ var images = {
   clearAnsiCache
 };
 
+// src/panels/index.ts
+var _splitBlock = (block) => {
+  if (typeof block !== "string" || block.length === 0) {
+    return { lines: [""], maxWidth: 0 };
+  }
+  const lines = block.split("\n");
+  let maxWidth = 0;
+  for (const line of lines) {
+    const w = visibleLen(line);
+    if (w > maxWidth) maxWidth = w;
+  }
+  return { lines, maxWidth };
+};
+var _padLinesRight = (lines, targetWidth) => {
+  return lines.map((line) => padEnd(line, targetWidth, " "));
+};
+var _padLinesAligned = (lines, targetWidth, align) => {
+  return lines.map((line) => {
+    const w = visibleLen(line);
+    const space = Math.max(0, targetWidth - w);
+    if (space === 0) return line;
+    if (align === "end") return " ".repeat(space) + line;
+    if (align === "center") {
+      const left = Math.floor(space / 2);
+      const right = space - left;
+      return " ".repeat(left) + line + " ".repeat(right);
+    }
+    return line + " ".repeat(space);
+  });
+};
+var _alignVertical = (lines, targetLines, width, align) => {
+  const current = lines.length;
+  if (current >= targetLines) return lines.slice(0, targetLines);
+  const diff = targetLines - current;
+  const empty = " ".repeat(width);
+  if (align === "end") {
+    return [...Array(diff).fill(empty), ...lines];
+  }
+  if (align === "center") {
+    const above = Math.floor(diff / 2);
+    const below = diff - above;
+    return [...Array(above).fill(empty), ...lines, ...Array(below).fill(empty)];
+  }
+  return [...lines, ...Array(diff).fill(empty)];
+};
+var vsplit = (blocks, opts = {}) => {
+  if (!Array.isArray(blocks) || blocks.length === 0) return "";
+  const { gap = 1, align = "start", widths = null } = opts;
+  const safeGap = Math.max(0, Math.floor(gap));
+  const splits = blocks.map((b) => _splitBlock(b));
+  const colWidths = splits.map((s, i) => {
+    if (widths && Array.isArray(widths) && widths[i] != null) {
+      return Math.max(0, Math.floor(widths[i]));
+    }
+    return s.maxWidth;
+  });
+  const targetLines = splits.reduce((m, s) => Math.max(m, s.lines.length), 0);
+  const normalized = splits.map((s, i) => {
+    const w = colWidths[i];
+    const padded = _padLinesRight(s.lines, w);
+    return _alignVertical(padded, targetLines, w, align);
+  });
+  const gapStr = " ".repeat(safeGap);
+  const result = [];
+  for (let r = 0; r < targetLines; r++) {
+    const row = normalized.map((block) => block[r] ?? "").join(gapStr);
+    result.push(row);
+  }
+  return result.join("\n");
+};
+var hsplit = (blocks, opts = {}) => {
+  if (!Array.isArray(blocks) || blocks.length === 0) return "";
+  const { gap = 0, align = "start" } = opts;
+  const safeGap = Math.max(0, Math.floor(gap));
+  const splits = blocks.map((b) => _splitBlock(b));
+  const maxWidth = splits.reduce((m, s) => Math.max(m, s.maxWidth), 0);
+  const aligned = splits.map((s) => _padLinesAligned(s.lines, maxWidth, align));
+  const gapLines = safeGap > 0 ? Array(safeGap).fill(" ".repeat(maxWidth)) : [];
+  const parts = [];
+  for (let i = 0; i < aligned.length; i++) {
+    parts.push(...aligned[i]);
+    if (i < aligned.length - 1 && gapLines.length > 0) {
+      parts.push(...gapLines);
+    }
+  }
+  return parts.join("\n");
+};
+var center2 = (block, opts) => {
+  if (!opts || typeof opts !== "object") return block;
+  const width = Math.max(0, Math.floor(opts.width ?? 0));
+  if (width === 0) return block;
+  const { lines, maxWidth } = _splitBlock(block);
+  const hCentered = lines.map((line) => {
+    const w = visibleLen(line);
+    const space = Math.max(0, width - w);
+    if (space === 0) return line.slice(0, width);
+    const left = Math.floor(space / 2);
+    const right = space - left;
+    return " ".repeat(left) + line + " ".repeat(right);
+  });
+  if (opts.height != null) {
+    const targetH = Math.max(1, Math.floor(opts.height));
+    return _alignVertical(hCentered, targetH, width, opts.align ?? "center").join("\n");
+  }
+  void maxWidth;
+  return hCentered.join("\n");
+};
+var frame = (block, opts = {}) => {
+  const {
+    padding = 0,
+    paddingY,
+    paddingX,
+    topChar = "\u2500",
+    bottomChar,
+    title
+  } = opts;
+  const safePadY = Math.max(0, Math.floor(paddingY ?? padding));
+  const safePadX = Math.max(0, Math.floor(paddingX ?? padding));
+  const safeTop = typeof topChar === "string" && topChar.length > 0 ? topChar.charAt(0) : "\u2500";
+  const safeBot = typeof bottomChar === "string" && bottomChar.length > 0 ? bottomChar.charAt(0) : safeTop;
+  const { lines, maxWidth } = _splitBlock(block);
+  const contentInnerW = maxWidth + 2 * safePadX;
+  let innerW = contentInnerW;
+  let titleStr = "";
+  let titleW = 0;
+  if (typeof title === "string" && title.length > 0) {
+    titleStr = ` ${title} `;
+    titleW = visibleLen(titleStr);
+    const titleNeededW = titleW + 2;
+    if (titleNeededW > innerW) {
+      innerW = titleNeededW;
+    }
+  }
+  let topLine;
+  if (titleStr.length > 0 && titleW < innerW) {
+    const before = Math.floor((innerW - titleW) / 2);
+    const after = innerW - titleW - before;
+    topLine = safeTop.repeat(before) + titleStr + safeTop.repeat(after);
+  } else {
+    topLine = safeTop.repeat(innerW);
+  }
+  const bottomLine = safeBot.repeat(innerW);
+  const padX = " ".repeat(safePadX);
+  const padded = lines.map((line) => {
+    const w = visibleLen(line);
+    const tail = " ".repeat(Math.max(0, innerW - safePadX - w - safePadX));
+    return padX + line + tail + padX;
+  });
+  const blank = " ".repeat(innerW);
+  const out = [];
+  out.push(topLine);
+  for (let i = 0; i < safePadY; i++) out.push(blank);
+  out.push(...padded);
+  for (let i = 0; i < safePadY; i++) out.push(blank);
+  out.push(bottomLine);
+  return out.join("\n");
+};
+var panels = {
+  vsplit,
+  hsplit,
+  // v1.3.1
+  center: center2,
+  frame
+};
+
+// src/json/index.ts
+var COLORS = {
+  key: FG.cyan,
+  string: FG.green,
+  number: FG.yellow,
+  boolean: FG.magenta,
+  null: FG.brightBlack,
+  bracket: FG.white,
+  comment: FG.brightBlack
+};
+var _c = (text, code, useColor) => useColor ? sgr(code) + text + reset() : text;
+var _truncString = (s, maxLength) => {
+  if (!Number.isFinite(maxLength) || s.length <= maxLength) return s;
+  if (maxLength <= 3) return s.slice(0, maxLength);
+  return s.slice(0, maxLength - 3) + "...";
+};
+var _formatPrimitive = (value, opts) => {
+  const { useColor, maxStringLength } = opts;
+  if (value === null) {
+    return _c("null", COLORS.null, useColor);
+  }
+  if (value === void 0) {
+    return _c("undefined", COLORS.null, useColor);
+  }
+  if (typeof value === "string") {
+    const truncated = _truncString(value, maxStringLength);
+    const quoted = JSON.stringify(truncated);
+    return _c(quoted, COLORS.string, useColor);
+  }
+  if (typeof value === "number") {
+    if (Number.isNaN(value)) return _c("NaN", COLORS.number, useColor);
+    if (!Number.isFinite(value)) {
+      return _c(value > 0 ? "Infinity" : "-Infinity", COLORS.number, useColor);
+    }
+    return _c(String(value), COLORS.number, useColor);
+  }
+  if (typeof value === "boolean") {
+    return _c(String(value), COLORS.boolean, useColor);
+  }
+  if (typeof value === "bigint") {
+    return _c(`${value}n`, COLORS.number, useColor);
+  }
+  if (typeof value === "function") {
+    const name = value.name || "anonymous";
+    return _c(`[Function: ${name}]`, COLORS.comment, useColor);
+  }
+  if (typeof value === "symbol") {
+    return _c(value.toString(), COLORS.comment, useColor);
+  }
+  return _c(String(value), COLORS.comment, useColor);
+};
+var _renderValue = (value, depth, config) => {
+  const {
+    indent,
+    maxDepth,
+    maxItems,
+    maxStringLength,
+    useColor,
+    seen,
+    sortKeys,
+    inlineArrayMaxLength
+  } = config;
+  if (value === null || typeof value !== "object") {
+    return _formatPrimitive(value, { useColor, maxStringLength });
+  }
+  if (seen.has(value)) {
+    return _c("[Circular]", COLORS.comment, useColor);
+  }
+  seen.add(value);
+  if (depth >= maxDepth) {
+    if (Array.isArray(value)) {
+      return _c("[", COLORS.bracket, useColor) + _c("...", COLORS.comment, useColor) + _c("]", COLORS.bracket, useColor);
+    }
+    return _c("{", COLORS.bracket, useColor) + _c("...", COLORS.comment, useColor) + _c("}", COLORS.bracket, useColor);
+  }
+  const pad = " ".repeat(indent * (depth + 1));
+  const closePad = " ".repeat(indent * depth);
+  if (Array.isArray(value)) {
+    if (value.length === 0) {
+      return _c("[]", COLORS.bracket, useColor);
+    }
+    if (inlineArrayMaxLength > 0) {
+      const allPrimitive = value.every((v) => v === null || typeof v !== "object");
+      if (allPrimitive) {
+        const displayCount2 = Math.min(value.length, maxItems);
+        const inlineItems = [];
+        for (let i = 0; i < displayCount2; i++) {
+          inlineItems.push(_formatPrimitive(value[i], { useColor, maxStringLength }));
+        }
+        if (value.length > maxItems) {
+          const remaining = value.length - maxItems;
+          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) {
+          return candidate;
+        }
+      }
+    }
+    const items = [];
+    const displayCount = Math.min(value.length, maxItems);
+    for (let i = 0; i < displayCount; i++) {
+      const rendered = _renderValue(value[i], depth + 1, config);
+      items.push(pad + rendered);
+    }
+    if (value.length > maxItems) {
+      const remaining = value.length - maxItems;
+      items.push(pad + _c(`... (${remaining} more)`, COLORS.comment, useColor));
+    }
+    return _c("[", COLORS.bracket, useColor) + "\n" + items.join(",\n") + "\n" + closePad + _c("]", COLORS.bracket, useColor);
+  }
+  let keys = Object.keys(value);
+  if (keys.length === 0) {
+    return _c("{}", COLORS.bracket, useColor);
+  }
+  if (sortKeys) {
+    keys = [...keys].sort((a, b) => a.localeCompare(b));
+  }
+  const entries = [];
+  for (const key of keys) {
+    const keyStr = JSON.stringify(key);
+    const renderedKey = _c(keyStr, COLORS.key, useColor);
+    const renderedVal = _renderValue(
+      value[key],
+      depth + 1,
+      config
+    );
+    entries.push(`${pad}${renderedKey}: ${renderedVal}`);
+  }
+  return _c("{", COLORS.bracket, useColor) + "\n" + entries.join(",\n") + "\n" + closePad + _c("}", COLORS.bracket, useColor);
+};
+var pretty = (value, opts = {}) => {
+  const {
+    indent = 2,
+    colors = true,
+    maxDepth = Infinity,
+    maxItems = Infinity,
+    maxStringLength = Infinity,
+    // v1.3.1
+    sortKeys = false,
+    inlineArrayMaxLength = 60
+  } = opts;
+  const safeIndent = Math.max(0, Math.floor(Number(indent) || 0));
+  const safeMaxDepth = Number.isFinite(maxDepth) ? Math.max(0, Math.floor(maxDepth)) : Infinity;
+  const safeMaxItems = Number.isFinite(maxItems) ? Math.max(0, Math.floor(maxItems)) : Infinity;
+  const safeMaxStrLen = Number.isFinite(maxStringLength) ? Math.max(0, Math.floor(maxStringLength)) : Infinity;
+  const safeInlineMax = Number.isFinite(inlineArrayMaxLength) ? Math.max(0, Math.floor(inlineArrayMaxLength)) : 60;
+  const useColor = colors && !isNoColor();
+  return _renderValue(value, 0, {
+    indent: safeIndent,
+    maxDepth: safeMaxDepth,
+    maxItems: safeMaxItems,
+    maxStringLength: safeMaxStrLen,
+    useColor,
+    seen: /* @__PURE__ */ new WeakSet(),
+    sortKeys: Boolean(sortKeys),
+    inlineArrayMaxLength: safeInlineMax
+  });
+};
+var json = {
+  pretty
+};
+
 // src/configure.ts
 var DEFAULTS = Object.freeze({
   colorMode: "auto",
@@ -5671,6 +6000,7 @@ export {
   canAnimate,
   cancelTerminalFrame,
   center,
+  center2 as centerBlock,
   chain,
   charWidth,
   clamp,
@@ -5701,6 +6031,7 @@ export {
   findInTree,
   flipHorizontal,
   flipVertical,
+  frame,
   frames,
   fromImage,
   getConfig,
@@ -5716,9 +6047,12 @@ export {
   hasFont,
   hexToRgb,
   hideCursor,
+  hsplit,
   images,
   isHexColor,
   isNoColor,
+  json,
+  pretty as jsonPretty,
   lerp,
   lerpColor,
   link,
@@ -5736,6 +6070,7 @@ export {
   padBoth,
   padEnd,
   padStart,
+  panels,
   parseFiglet,
   pauseListeners,
   presetNames,
@@ -5781,6 +6116,7 @@ export {
   trees,
   truncateAnsi,
   visibleLen,
+  vsplit,
   walkTree,
   withConfig,
   wordWrap,

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

package/package.json

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