ansimax 1.3.0 → 1.3.1

package/dist/index.js

@@ -56,6 +56,7 @@ __export(index_exports, {
   canAnimate: () => canAnimate,
   cancelTerminalFrame: () => cancelTerminalFrame,
   center: () => center,
+  centerBlock: () => center2,
   chain: () => chain,
   charWidth: () => charWidth,
   clamp: () => clamp,
@@ -86,6 +87,7 @@ __export(index_exports, {
   findInTree: () => findInTree,
   flipHorizontal: () => flipHorizontal,
   flipVertical: () => flipVertical,
+  frame: () => frame,
   frames: () => frames,
   fromImage: () => fromImage,
   getConfig: () => getConfig,
@@ -1347,13 +1349,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 {
       }
@@ -1643,9 +1645,9 @@ var safeWrite = (data) => {
   } catch {
   }
 };
-var fireFrame = (hooks, frame) => {
+var fireFrame = (hooks, frame2) => {
   try {
-    hooks?.onFrame?.(frame);
+    hooks?.onFrame?.(frame2);
   } catch {
   }
 };
@@ -1677,7 +1679,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)) {
@@ -1685,7 +1687,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 {
@@ -1856,7 +1858,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)) {
@@ -1866,7 +1868,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;
@@ -1875,7 +1877,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) {
@@ -3020,7 +3022,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);
@@ -3029,8 +3031,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();
@@ -3243,7 +3245,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);
@@ -3251,8 +3253,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();
@@ -3360,7 +3362,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 = () => {
@@ -3374,13 +3376,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;
@@ -3541,9 +3543,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) => {
@@ -3554,7 +3556,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();
@@ -3615,13 +3617,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 {
@@ -3750,13 +3752,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;
@@ -5700,9 +5702,82 @@ var hsplit = (blocks, opts = {}) => {
   }
   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
+  hsplit,
+  // v1.3.1
+  center: center2,
+  frame
 };
 
 // src/json/index.ts
@@ -5757,7 +5832,16 @@ var _formatPrimitive = (value, opts) => {
   return _c(String(value), COLORS.comment, useColor);
 };
 var _renderValue = (value, depth, config) => {
-  const { indent, maxDepth, maxItems, maxStringLength, useColor, seen } = config;
+  const {
+    indent,
+    maxDepth,
+    maxItems,
+    maxStringLength,
+    useColor,
+    seen,
+    sortKeys,
+    inlineArrayMaxLength
+  } = config;
   if (value === null || typeof value !== "object") {
     return _formatPrimitive(value, { useColor, maxStringLength });
   }
@@ -5777,6 +5861,25 @@ var _renderValue = (value, depth, config) => {
     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++) {
@@ -5789,10 +5892,13 @@ var _renderValue = (value, depth, config) => {
     }
     return _c("[", COLORS.bracket, useColor) + "\n" + items.join(",\n") + "\n" + closePad + _c("]", COLORS.bracket, useColor);
   }
-  const keys = Object.keys(value);
+  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);
@@ -5812,12 +5918,16 @@ var pretty = (value, opts = {}) => {
     colors = true,
     maxDepth = Infinity,
     maxItems = Infinity,
-    maxStringLength = 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,
@@ -5825,7 +5935,9 @@ var pretty = (value, opts = {}) => {
     maxItems: safeMaxItems,
     maxStringLength: safeMaxStrLen,
     useColor,
-    seen: /* @__PURE__ */ new WeakSet()
+    seen: /* @__PURE__ */ new WeakSet(),
+    sortKeys: Boolean(sortKeys),
+    inlineArrayMaxLength: safeInlineMax
   });
 };
 var json = {
@@ -6076,6 +6188,7 @@ var index_default = ansimax;
   canAnimate,
   cancelTerminalFrame,
   center,
+  centerBlock,
   chain,
   charWidth,
   clamp,
@@ -6105,6 +6218,7 @@ var index_default = ansimax;
   findInTree,
   flipHorizontal,
   flipVertical,
+  frame,
   frames,
   fromImage,
   getConfig,