ansimax 1.2.8 → 1.3.0

package/dist/index.d.ts

@@ -1904,6 +1904,224 @@ declare const clearThemeColorCache: () => void;
  */
 declare const themes: ThemeInstance;
 
+/**
+ * ansimax — panels module
+ * ─────────────────────────────────────────────
+ *
+ * Split layouts for composing terminal UIs: hsplit (top/bottom) and
+ * vsplit (left/right). Both operate on already-rendered string blocks
+ * (typically from `ascii.box`, `components.table`, etc.) and handle:
+ *
+ *   • ANSI-aware width measurement
+ *   • Variable height (each block keeps its own line count)
+ *   • Alignment within columns
+ *   • Configurable gap between blocks
+ *   • Nesting (panels can contain panels)
+ *
+ * Philosophy: panels do composition, not styling. Style your blocks
+ * first (with `ascii.box`, `components.timeline`, etc.), then compose
+ * them with `panels.hsplit` / `panels.vsplit`.
+ */
+type Alignment = 'start' | 'center' | 'end';
+interface VsplitOptions {
+    /** Horizontal gap (in space characters) between columns. Default `1`. */
+    gap?: number;
+    /**
+     * Vertical alignment of shorter blocks within the joined column row.
+     * `'start'` (default) keeps blocks top-aligned; shorter blocks have
+     * padding below. `'center'` centers each block. `'end'` aligns to bottom.
+     */
+    align?: Alignment;
+    /**
+     * Pad each block with spaces to a fixed width. Useful for grids where
+     * each cell should be the same size regardless of content.
+     * If omitted, each column uses its natural max-line width.
+     */
+    widths?: number[] | null;
+}
+interface HsplitOptions {
+    /** Vertical gap (in blank lines) between rows. Default `0`. */
+    gap?: number;
+    /**
+     * Horizontal alignment of narrower blocks within the joined width.
+     * `'start'` (default) keeps blocks left-aligned. `'center'` and `'end'`
+     * pad with spaces on the appropriate side.
+     */
+    align?: Alignment;
+}
+/**
+ * Split blocks side-by-side (left / right / right ...).
+ *
+ * Each block is split into lines, then joined column-by-column with a
+ * configurable gap. Shorter blocks are padded to match the tallest one.
+ *
+ * @param blocks - Pre-rendered string blocks (multi-line OK).
+ * @param opts   - Layout options.
+ *
+ * @example basic two-column layout
+ * ```js
+ * import { panels, ascii } from 'ansimax';
+ *
+ * console.log(panels.vsplit([
+ *   ascii.box('Left side',  { borderStyle: 'rounded' }),
+ *   ascii.box('Right side', { borderStyle: 'rounded' }),
+ * ], { gap: 2 }));
+ * ```
+ *
+ * @example three columns with centered vertical alignment
+ * ```js
+ * console.log(panels.vsplit([
+ *   'Short',
+ *   'A\nMedium\nblock',
+ *   'A\nlonger\nblock\nwith\nfive lines',
+ * ], { align: 'center', gap: 4 }));
+ * ```
+ *
+ * @example fixed column widths (grid-like)
+ * ```js
+ * console.log(panels.vsplit([col1, col2, col3], {
+ *   widths: [20, 30, 20],
+ *   gap: 2,
+ * }));
+ * ```
+ */
+declare const vsplit: (blocks: string[], opts?: VsplitOptions) => string;
+/**
+ * Stack blocks vertically (top / bottom / bottom ...).
+ *
+ * Each block is concatenated with `\n` between them. With `gap > 0`,
+ * additional blank lines are inserted between blocks.
+ *
+ * @param blocks - Pre-rendered string blocks (multi-line OK).
+ * @param opts   - Layout options.
+ *
+ * @example basic stacking
+ * ```js
+ * import { panels, ascii } from 'ansimax';
+ *
+ * console.log(panels.hsplit([
+ *   '── Header ──',
+ *   ascii.box('Body content', { borderStyle: 'rounded' }),
+ *   '── Footer ──',
+ * ]));
+ * ```
+ *
+ * @example with vertical gap + centered alignment
+ * ```js
+ * console.log(panels.hsplit([
+ *   'Top',
+ *   ascii.box('Middle'),
+ *   'Bottom',
+ * ], { gap: 1, align: 'center' }));
+ * ```
+ *
+ * @example nested (an hsplit inside a vsplit)
+ * ```js
+ * const sidebar = ascii.box('Sidebar', { width: 20 });
+ * const main    = ascii.box('Main content area', { width: 40 });
+ *
+ * console.log(panels.hsplit([
+ *   '── Application ──',
+ *   panels.vsplit([sidebar, main], { gap: 2 }),
+ *   '── End ──',
+ * ]));
+ * ```
+ */
+declare const hsplit: (blocks: string[], opts?: HsplitOptions) => string;
+declare const panels: {
+    vsplit: (blocks: string[], opts?: VsplitOptions) => string;
+    hsplit: (blocks: string[], opts?: HsplitOptions) => string;
+};
+
+/**
+ * ansimax — json module
+ * ─────────────────────────────────────────────
+ *
+ * Colored JSON / YAML pretty-printer for terminal display.
+ *
+ * Features:
+ *   • Configurable indent
+ *   • Color-coded by value type (string, number, boolean, null, key)
+ *   • Max depth with collapse marker (`{...}` / `[...]`)
+ *   • Circular reference detection (avoids infinite recursion)
+ *   • ANSI cleanly disabled in NO_COLOR / non-TTY environments
+ *
+ * Philosophy: data → human-readable text. Not a parser, not a validator —
+ * just pretty rendering of in-memory JS values.
+ */
+interface PrettyOptions {
+    /** Indent width in spaces. Default `2`. */
+    indent?: number;
+    /**
+     * Apply ANSI colors to keys/values. Default `true`. Auto-disabled when
+     * `NO_COLOR` is set or output is non-TTY.
+     */
+    colors?: boolean;
+    /**
+     * Maximum nesting depth. Objects/arrays beyond this level are collapsed
+     * to `{...}` / `[...]`. Default `Infinity` (no limit).
+     */
+    maxDepth?: number;
+    /**
+     * Maximum array length to display fully. Arrays longer than this show
+     * the first N items + a `... (M more)` marker. Default `Infinity`.
+     */
+    maxItems?: number;
+    /**
+     * Maximum string length before truncation with ellipsis. Default `Infinity`.
+     */
+    maxStringLength?: number;
+}
+/**
+ * Pretty-print a JavaScript value with colored output suitable for
+ * terminal display. Handles primitives, objects, arrays, and circular
+ * references gracefully.
+ *
+ * @param value - Any JavaScript value to render.
+ * @param opts  - Optional formatting configuration.
+ *
+ * @example basic
+ * ```js
+ * import { json } from 'ansimax';
+ *
+ * console.log(json.pretty({
+ *   name: 'ansimax',
+ *   version: '1.3.0',
+ *   features: ['colors', 'gradients', 'panels'],
+ *   stats: { tests: 2000, coverage: 0.98 },
+ * }));
+ * ```
+ *
+ * @example with depth limit (collapses deeply nested objects)
+ * ```js
+ * console.log(json.pretty(deeplyNestedObject, { maxDepth: 2 }));
+ * // Anything beyond depth 2 renders as {...} or [...]
+ * ```
+ *
+ * @example with item limit (for huge arrays)
+ * ```js
+ * console.log(json.pretty(largeArray, { maxItems: 10 }));
+ * // Shows first 10 items + "... (N more)"
+ * ```
+ *
+ * @example monochrome (e.g. for log files)
+ * ```js
+ * console.log(json.pretty(data, { colors: false }));
+ * ```
+ *
+ * @example handles circular references
+ * ```js
+ * const obj = { name: 'foo' };
+ * obj.self = obj;  // circular!
+ * console.log(json.pretty(obj));
+ * // → { "name": "foo", "self": [Circular] }
+ * ```
+ */
+declare const pretty: (value: unknown, opts?: PrettyOptions) => string;
+declare const json: {
+    pretty: (value: unknown, opts?: PrettyOptions) => string;
+};
+
 declare const ansimax: {
     color: {
         black: ColorFn;
@@ -2070,4 +2288,4 @@ declare const ansimax: {
     configure: (opts?: AnsimaxConfig, meta?: ConfigureOptions) => void;
 };
 
-export { ASCII_RAMPS, type AnimateGradientController, type AnimateGradientOptions, type AnimationHooks, type AnimationSpeed, type AnsiCode, type AnsimaxConfig, type AsciiRamp, BEL, BG, type BadgeOptions, type BallOptions, type BannerOptions, type BoxOptions, type BoxStyle, type BreatheOptions, DEFAULTS as CONFIG_DEFAULTS, CSI, type Canvas, type CanvasRenderOptions, type ColorChain, type ColorFn, type ColorLevel, type ColorMode, type ColorSupport, type ColumnsOptions, type ConfigChangeListener, type ConfigKey, type ConfigKeyListener, type ConfigureOptions, type CountdownOptions, type CustomOptions, DEFAULT_TERM_COLS, DEFAULT_TERM_ROWS, type DebounceOptions, type DiffType, type Dimensions, type DividerOptions, type DotsOptions, ESC, type EasingFn, type EasingName, type EraseMode, FG, FRAME_MS, type FadeOptions, type FigletFont, type FigletOptions, type FontMap, type FontName, type FrameCallback, type FrameHandle, type FromImageOptions, type GlitchOptions, type Glyph, type GradientOptions, type GradientRectOptions, type LineDiff, type LiveController, type LiveOptions, type LoadingBarOptions, type LogoOptions, MENU_CANCELLED, type MemoizeOptions, type MenuInput, type MenuOptions, type MenuOutput, type MenuResult, type MultiLoader, type MultiLoaderItem, OSC, type OnResizeOptions, type OutputBuffer, type ParallelOptions, type ParallelStep, type Pixel, type PixelGrid, type PlayController, type PlayOptions, type PresetName, type ProgressAnimateOptions, type ProgressBarOptions, type ProgressOptions, type PulseOptions, type RGB, type RGBA, type RegisterFontOptions, type RenderOptions$1 as RenderOptions, type ResizeListener, type ReusableGradient, type RevealOptions, SPINNERS, SPRITES, ST, STYLE, type SectionOptions, type SleepOptions, type SlideOptions, type SpinOptions, type SpinnerType, type StatusOptions, type StatusType, type StopFn, type StreamOptions, type TableBorderStyle, type TableOptions, type Task, type TaskResult, type TasksOptions, type Theme, type BannerOpts as ThemeBannerOpts, type ThemeChangeListener, type ThemeInstance, type ThemeStyleName, type TimelineEvent, type TimelineOptions, type TreeData, type TreeDimensions, type TreeNode, type RenderOptions as TreeRenderOptions, type TreeStyle, type TypeDeleteOptions, type TypewriterOptions, type WalkVisitor, type WaveOptions, type WriteAsyncOptions, animate, animateGradient, ascii, bell, bg256, bgRgb, box, canAnimate, cancelTerminalFrame, center, chain, charWidth, clamp, clearAnsiCache, clearColorCache, clearRenderCache, clearThemeColorCache, color, colorLevel, presets as colorPresets, components, compose, configure, countNodes, createCanvas, createGradient, createOutputBuffer, createTheme, cursor, debounce, ansimax as default, diffLines, escapeRegex, fg256, fgRgb, figletText, filterTree, findInTree, flipHorizontal, flipVertical, frames, fromImage, getConfig, getConfigValue, getRenderCacheSize, getSpeedMultiplier, getTerminalHeight, getTerminalWidth, gradient, gradientColor, gradientRect, graphemes, hasFont, hexToRgb, hideCursor, images, isHexColor, isNoColor, lerp, lerpColor, link, listFonts, listPresets, loader, mapTree, measureTree, memoize, nextTick, onConfigChange, onConfigKeyChange, onResize, once, padBoth, padEnd, padStart, parseFiglet, pauseListeners, presetNames, presets, rainbow, registerFont, registerPreset, renderPixelArt, renderTree, renderTreeStream, repeatVisible, requestTerminalFrame, reset, resetColorSupportCache, resetConfig, resetCursorRefCount, resetFramesCursorCount, resetLoaderCursorCount, resetNoColor, resumeListeners, reverseGradient, rgbTo256, rgbToHex, rotate90, safeJson, screen, setNoColor, setTitle, sgr, showCursor, sleep, sleepFrame, sliceAnsi, stripAnsi$1 as stripAnsi, stripAnsi$2 as stripAnsiCodes, stripAnsi as stripAnsiColors, supportsColor, supportsColorLevel, termSize, themes, throttle, tree, trees, truncateAnsi, visibleLen, walkTree, withConfig, wordWrap, wrapAnsi, write, writeAsync, writeErr, writeln, writelnErr };
+export { ASCII_RAMPS, type Alignment, type AnimateGradientController, type AnimateGradientOptions, type AnimationHooks, type AnimationSpeed, type AnsiCode, type AnsimaxConfig, type AsciiRamp, BEL, BG, type BadgeOptions, type BallOptions, type BannerOptions, type BoxOptions, type BoxStyle, type BreatheOptions, DEFAULTS as CONFIG_DEFAULTS, CSI, type Canvas, type CanvasRenderOptions, type ColorChain, type ColorFn, type ColorLevel, type ColorMode, type ColorSupport, type ColumnsOptions, type ConfigChangeListener, type ConfigKey, type ConfigKeyListener, type ConfigureOptions, type CountdownOptions, type CustomOptions, DEFAULT_TERM_COLS, DEFAULT_TERM_ROWS, type DebounceOptions, type DiffType, type Dimensions, type DividerOptions, type DotsOptions, ESC, type EasingFn, type EasingName, type EraseMode, FG, FRAME_MS, type FadeOptions, type FigletFont, type FigletOptions, type FontMap, type FontName, type FrameCallback, type FrameHandle, type FromImageOptions, type GlitchOptions, type Glyph, type GradientOptions, type GradientRectOptions, type HsplitOptions, type PrettyOptions as JsonPrettyOptions, type LineDiff, type LiveController, type LiveOptions, type LoadingBarOptions, type LogoOptions, MENU_CANCELLED, type MemoizeOptions, type MenuInput, type MenuOptions, type MenuOutput, type MenuResult, type MultiLoader, type MultiLoaderItem, OSC, type OnResizeOptions, type OutputBuffer, type ParallelOptions, type ParallelStep, type Pixel, type PixelGrid, type PlayController, type PlayOptions, type PresetName, type ProgressAnimateOptions, type ProgressBarOptions, type ProgressOptions, type PulseOptions, type RGB, type RGBA, type RegisterFontOptions, type RenderOptions$1 as RenderOptions, type ResizeListener, type ReusableGradient, type RevealOptions, SPINNERS, SPRITES, ST, STYLE, type SectionOptions, type SleepOptions, type SlideOptions, type SpinOptions, type SpinnerType, type StatusOptions, type StatusType, type StopFn, type StreamOptions, type TableBorderStyle, type TableOptions, type Task, type TaskResult, type TasksOptions, type Theme, type BannerOpts as ThemeBannerOpts, type ThemeChangeListener, type ThemeInstance, type ThemeStyleName, type TimelineEvent, type TimelineOptions, type TreeData, type TreeDimensions, type TreeNode, type RenderOptions as TreeRenderOptions, type TreeStyle, type TypeDeleteOptions, type TypewriterOptions, type VsplitOptions, type WalkVisitor, type WaveOptions, type WriteAsyncOptions, animate, animateGradient, ascii, bell, bg256, bgRgb, box, canAnimate, cancelTerminalFrame, center, chain, charWidth, clamp, clearAnsiCache, clearColorCache, clearRenderCache, clearThemeColorCache, color, colorLevel, presets as colorPresets, components, compose, configure, countNodes, createCanvas, createGradient, createOutputBuffer, createTheme, cursor, debounce, ansimax as default, diffLines, escapeRegex, fg256, fgRgb, figletText, filterTree, findInTree, flipHorizontal, flipVertical, frames, fromImage, getConfig, getConfigValue, getRenderCacheSize, getSpeedMultiplier, getTerminalHeight, getTerminalWidth, gradient, gradientColor, gradientRect, graphemes, hasFont, hexToRgb, hideCursor, hsplit, images, isHexColor, isNoColor, json, pretty as jsonPretty, lerp, lerpColor, link, listFonts, listPresets, loader, mapTree, measureTree, memoize, nextTick, onConfigChange, onConfigKeyChange, onResize, once, padBoth, padEnd, padStart, panels, parseFiglet, pauseListeners, presetNames, presets, rainbow, registerFont, registerPreset, renderPixelArt, renderTree, renderTreeStream, repeatVisible, requestTerminalFrame, reset, resetColorSupportCache, resetConfig, resetCursorRefCount, resetFramesCursorCount, resetLoaderCursorCount, resetNoColor, resumeListeners, reverseGradient, rgbTo256, rgbToHex, rotate90, safeJson, screen, setNoColor, setTitle, sgr, showCursor, sleep, sleepFrame, sliceAnsi, stripAnsi$1 as stripAnsi, stripAnsi$2 as stripAnsiCodes, stripAnsi as stripAnsiColors, supportsColor, supportsColorLevel, termSize, themes, throttle, tree, trees, truncateAnsi, visibleLen, vsplit, walkTree, withConfig, wordWrap, wrapAnsi, write, writeAsync, writeErr, writeln, writelnErr };

package/dist/index.js

@@ -101,9 +101,12 @@ __export(index_exports, {
   hasFont: () => hasFont,
   hexToRgb: () => hexToRgb,
   hideCursor: () => hideCursor,
+  hsplit: () => hsplit,
   images: () => images,
   isHexColor: () => isHexColor,
   isNoColor: () => isNoColor,
+  json: () => json,
+  jsonPretty: () => pretty,
   lerp: () => lerp,
   lerpColor: () => lerpColor,
   link: () => link,
@@ -121,6 +124,7 @@ __export(index_exports, {
   padBoth: () => padBoth,
   padEnd: () => padEnd,
   padStart: () => padStart,
+  panels: () => panels,
   parseFiglet: () => parseFiglet,
   pauseListeners: () => pauseListeners,
   presetNames: () => presetNames,
@@ -166,6 +170,7 @@ __export(index_exports, {
   trees: () => trees,
   truncateAnsi: () => truncateAnsi,
   visibleLen: () => visibleLen,
+  vsplit: () => vsplit,
   walkTree: () => walkTree,
   withConfig: () => withConfig,
   wordWrap: () => wordWrap,
@@ -5608,6 +5613,225 @@ 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 panels = {
+  vsplit,
+  hsplit
+};
+
+// 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 } = 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);
+    }
+    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);
+  }
+  const keys = Object.keys(value);
+  if (keys.length === 0) {
+    return _c("{}", COLORS.bracket, useColor);
+  }
+  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
+  } = 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 useColor = colors && !isNoColor();
+  return _renderValue(value, 0, {
+    indent: safeIndent,
+    maxDepth: safeMaxDepth,
+    maxItems: safeMaxItems,
+    maxStringLength: safeMaxStrLen,
+    useColor,
+    seen: /* @__PURE__ */ new WeakSet()
+  });
+};
+var json = {
+  pretty
+};
+
 // src/configure.ts
 var DEFAULTS = Object.freeze({
   colorMode: "auto",
@@ -5896,9 +6120,12 @@ var index_default = ansimax;
   hasFont,
   hexToRgb,
   hideCursor,
+  hsplit,
   images,
   isHexColor,
   isNoColor,
+  json,
+  jsonPretty,
   lerp,
   lerpColor,
   link,
@@ -5916,6 +6143,7 @@ var index_default = ansimax;
   padBoth,
   padEnd,
   padStart,
+  panels,
   parseFiglet,
   pauseListeners,
   presetNames,
@@ -5961,6 +6189,7 @@ var index_default = ansimax;
   trees,
   truncateAnsi,
   visibleLen,
+  vsplit,
   walkTree,
   withConfig,
   wordWrap,