ansimax 1.3.2 → 1.3.3

package/dist/index.d.ts

@@ -1279,6 +1279,20 @@ interface BoxOptions {
     borderStyle?: BoxStyle;
     /** Fix inner content width. Lines are padded/truncated to fit. */
     width?: number | null;
+    /**
+     * Optional title shown in the top border, e.g. `─ Title ─────`.
+     * When set, the box expands to fit the title if content is narrower.
+     *
+     * @since 1.3.3
+     */
+    title?: string | null;
+    /**
+     * Title alignment in the top border: `'left'` | `'center'` (default) | `'right'`.
+     * Only applies when `title` is set.
+     *
+     * @since 1.3.3
+     */
+    titleAlign?: 'left' | 'center' | 'right';
 }
 interface BannerOptions {
     font?: FontName | string;
@@ -1294,6 +1308,13 @@ interface DividerOptions {
     width?: number | null;
     label?: string | null;
     style?: BoxStyle;
+    /**
+     * Label alignment: `'left'` | `'center'` (default) | `'right'`.
+     * Only applies when `label` is set.
+     *
+     * @since 1.3.3
+     */
+    align?: 'left' | 'center' | 'right';
 }
 interface LogoOptions {
     gradient?: ColorFn | null;
@@ -2299,9 +2320,16 @@ interface FrameOptions {
      */
     bottomChar?: string;
     /**
-     * Optional title shown centered in the top edge.
+     * Optional title shown in the top edge.
      */
     title?: string;
+    /**
+     * Title alignment: `'left'` | `'center'` (default) | `'right'`.
+     * Only applies when `title` is set.
+     *
+     * @since 1.3.3
+     */
+    titleAlign?: 'left' | 'center' | 'right';
 }
 /**
  * Add decorative top/bottom rule lines around a block (lighter than `ascii.box`
@@ -2339,11 +2367,71 @@ interface FrameOptions {
  * ```
  */
 declare const frame: (block: string, opts?: FrameOptions) => string;
+interface GridOptions {
+    /** Number of columns. Required. */
+    columns: number;
+    /** Horizontal gap between cells. Default `1`. */
+    gapX?: number;
+    /** Vertical gap between rows. Default `0`. */
+    gapY?: number;
+    /** Horizontal alignment of content within each cell. Default `'start'`. */
+    alignX?: Alignment;
+    /** Vertical alignment of content within each cell. Default `'start'`. */
+    alignY?: Alignment;
+    /**
+     * Fix each cell to this width (in visible characters). If omitted, cells
+     * use the max width of the widest block in their column.
+     */
+    cellWidth?: number | null;
+}
+/**
+ * Arrange blocks in a grid of N columns, flowing left-to-right then
+ * top-to-bottom. Each row is auto-sized to its tallest block, and each
+ * column is auto-sized to its widest block (unless `cellWidth` is fixed).
+ *
+ * Internally uses `vsplit` for rows + `hsplit` for the column stack, so
+ * all alignment + ANSI rules behave consistently.
+ *
+ * @param blocks - Pre-rendered string blocks. Flows in reading order.
+ * @param opts   - Grid configuration. `columns` is required.
+ *
+ * @example 2×2 grid of stats cards
+ * ```js
+ * import { panels, ascii } from 'ansimax';
+ *
+ * const cards = [
+ *   ascii.box('FILES\n42',   { borderStyle: 'rounded', padding: 1 }),
+ *   ascii.box('LINES\n1247', { borderStyle: 'rounded', padding: 1 }),
+ *   ascii.box('TESTS\n38',   { borderStyle: 'rounded', padding: 1 }),
+ *   ascii.box('COV\n98%',    { borderStyle: 'rounded', padding: 1 }),
+ * ];
+ *
+ * console.log(panels.grid(cards, { columns: 2, gapX: 2, gapY: 1 }));
+ * ```
+ *
+ * @example 3-column gallery with auto-flow
+ * ```js
+ * // 7 items in 3 columns → 3 rows: [3, 3, 1]
+ * const items = ['One', 'Two', 'Three', 'Four', 'Five', 'Six', 'Seven'];
+ * console.log(panels.grid(items, { columns: 3, gapX: 4 }));
+ * ```
+ *
+ * @example uniform cell width for visual consistency
+ * ```js
+ * console.log(panels.grid(blocks, {
+ *   columns: 4,
+ *   cellWidth: 15,
+ *   alignX: 'center',
+ * }));
+ * ```
+ */
+declare const grid: (blocks: string[], opts: GridOptions) => string;
 declare const panels: {
     vsplit: (blocks: string[], opts?: VsplitOptions) => string;
     hsplit: (blocks: string[], opts?: HsplitOptions) => string;
     center: (block: string, opts: CenterOptions) => string;
     frame: (block: string, opts?: FrameOptions) => string;
+    grid: (blocks: string[], opts: GridOptions) => string;
 };
 
 /**
@@ -2401,6 +2489,23 @@ interface PrettyOptions {
      * @since 1.3.1
      */
     inlineArrayMaxLength?: number;
+    /**
+     * Output mode controls what kind of string is produced:
+     *
+     * - `'display'` (default) — terminal-friendly output with colors (when
+     *   enabled) and informational placeholders like `[Circular]`,
+     *   `[Function: name]`, `Symbol(x)`, `Map(2) {...}`, `Set(3) {...}`,
+     *   `Date(2026-06-13T...)`, `BigInt(123n)`. Not parseable as JSON.
+     *
+     * - `'json'` — strict, parseable JSON output. Colors are forced off,
+     *   circular references throw `TypeError`, and types not representable
+     *   in JSON (functions, symbols, undefined) are omitted from objects /
+     *   replaced with `null` in arrays. Map/Set are converted to objects/arrays.
+     *   Dates become ISO strings. BigInt becomes a number (or string if too large).
+     *
+     * @since 1.3.3
+     */
+    mode?: 'display' | 'json';
 }
 /**
  * Pretty-print a JavaScript value with colored output suitable for
@@ -2618,4 +2723,4 @@ declare const ansimax: {
     configure: (opts?: AnsimaxConfig, meta?: ConfigureOptions) => void;
 };
 
-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 CenterOptions, 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 FrameOptions, 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$1 as center, center as centerBlock, 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, frame, 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 };
+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 CenterOptions, 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 FrameOptions, type FromImageOptions, type GlitchOptions, type Glyph, type GradientOptions, type GradientRectOptions, type GridOptions, 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$1 as center, center as centerBlock, 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, frame, frames, fromImage, getConfig, getConfigValue, getRenderCacheSize, getSpeedMultiplier, getTerminalHeight, getTerminalWidth, gradient, gradientColor, gradientRect, graphemes, grid, 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

@@ -100,6 +100,7 @@ __export(index_exports, {
   gradientColor: () => gradientColor,
   gradientRect: () => gradientRect,
   graphemes: () => graphemes,
+  grid: () => grid,
   hasFont: () => hasFont,
   hexToRgb: () => hexToRgb,
   hideCursor: () => hideCursor,
@@ -2457,23 +2458,61 @@ var banner = (text, opts = {}) => {
 };
 var box = (text, opts = {}) => {
   const safe = ensureString2(text, "box(text)");
-  const { padding = 1, borderStyle = "rounded", width = null } = opts;
+  const {
+    padding = 1,
+    borderStyle = "rounded",
+    width = null,
+    title = null,
+    // v1.3.3
+    titleAlign = "center"
+    // v1.3.3
+  } = opts;
   const padNum = typeof padding === "number" && Number.isFinite(padding) ? padding : 1;
   const safePadding = Math.max(0, Math.floor(padNum));
   const b = BOX_STYLES[borderStyle] ?? BOX_STYLES.rounded;
   const lines = safe.split("\n");
   const inner = width != null ? lines.map((l) => padEnd(truncateAnsi(l, width, ""), width)) : lines;
-  const w = inner.length > 0 ? Math.max(0, ...inner.map((l) => visibleLen(l))) : 0;
+  const contentW = inner.length > 0 ? Math.max(0, ...inner.map((l) => visibleLen(l))) : 0;
+  let w = contentW;
+  let titleStr = "";
+  let titleW = 0;
+  if (typeof title === "string" && title.length > 0) {
+    titleStr = ` ${title} `;
+    titleW = visibleLen(titleStr);
+    const titleNeeded = titleW + 2;
+    const innerNeeded = w + safePadding * 2;
+    if (titleNeeded > innerNeeded) {
+      w = titleNeeded - safePadding * 2;
+    }
+  }
+  const innerW = w + safePadding * 2;
   const pad = " ".repeat(safePadding);
-  const top = b.tl + b.h.repeat(w + safePadding * 2) + b.tr;
-  const bottom = b.bl + b.h.repeat(w + safePadding * 2) + b.br;
-  const emptyRow = b.v + " ".repeat(w + safePadding * 2) + b.v;
+  let top;
+  if (titleStr.length > 0 && titleW < innerW) {
+    let before;
+    let after;
+    if (titleAlign === "left") {
+      before = 1;
+      after = innerW - titleW - before;
+    } else if (titleAlign === "right") {
+      after = 1;
+      before = innerW - titleW - after;
+    } else {
+      before = Math.floor((innerW - titleW) / 2);
+      after = innerW - titleW - before;
+    }
+    top = b.tl + b.h.repeat(before) + titleStr + b.h.repeat(after) + b.tr;
+  } else {
+    top = b.tl + b.h.repeat(innerW) + b.tr;
+  }
+  const bottom = b.bl + b.h.repeat(innerW) + b.br;
+  const emptyRow = b.v + " ".repeat(innerW) + b.v;
   const rows = inner.map((l) => b.v + pad + padEnd(l, w) + pad + b.v);
   const vPad = Array(safePadding).fill(emptyRow);
   return [top, ...vPad, ...rows, ...vPad, bottom].join("\n");
 };
 var divider = (opts = {}) => {
-  const { char, width = null, label = null, style = "single" } = opts;
+  const { char, width = null, label = null, style = "single", align = "center" } = opts;
   const { cols } = termSize();
   const w = Math.max(0, width ?? cols);
   const b = BOX_STYLES[style] ?? BOX_STYLES.single;
@@ -2482,8 +2521,18 @@ var divider = (opts = {}) => {
   if (label) {
     const labelLen = visibleLen(label);
     if (labelLen >= w - 2) return label;
-    const side = Math.max(0, Math.floor((w - labelLen - 2) / 2));
-    const trailLen = Math.max(0, w - side - labelLen - 2);
+    let side;
+    let trailLen;
+    if (align === "left") {
+      side = 1;
+      trailLen = Math.max(0, w - labelLen - side - 2);
+    } else if (align === "right") {
+      trailLen = 1;
+      side = Math.max(0, w - labelLen - trailLen - 2);
+    } else {
+      side = Math.max(0, Math.floor((w - labelLen - 2) / 2));
+      trailLen = Math.max(0, w - side - labelLen - 2);
+    }
     return fill.repeat(side) + " " + label + " " + fill.repeat(trailLen);
   }
   return fill.repeat(w);
@@ -5136,16 +5185,16 @@ var ensurePixelGrid = (pixels) => {
   return pixels.map((row) => Array.isArray(row) ? row : []);
 };
 var renderPixelArt = (pixels, opts = {}) => {
-  const grid = ensurePixelGrid(pixels);
-  if (!grid || grid.length === 0) return "";
+  const grid2 = ensurePixelGrid(pixels);
+  if (!grid2 || grid2.length === 0) return "";
   const { scale = 1, halfBlock = true, braille = false } = opts;
   const safeScale = clampInt(scale, 1, 100, 1);
-  if (braille) return _renderBraille(grid);
+  if (braille) return _renderBraille(grid2);
   const lines = [];
   if (halfBlock) {
-    for (let row = 0; row < grid.length; row += 2) {
-      const topRow = grid[row] ?? [];
-      const botRow = grid[row + 1] ?? [];
+    for (let row = 0; row < grid2.length; row += 2) {
+      const topRow = grid2[row] ?? [];
+      const botRow = grid2[row + 1] ?? [];
       const colCount = Math.max(topRow.length, botRow.length);
       let line = "";
       let curFg = -1;
@@ -5202,7 +5251,7 @@ var renderPixelArt = (pixels, opts = {}) => {
       lines.push(line);
     }
   } else {
-    for (const row of grid) {
+    for (const row of grid2) {
       let line = "";
       let curFg = -1;
       for (const pixel of row) {
@@ -5317,24 +5366,24 @@ var SPRITES = {
   ] }
 };
 var flipHorizontal = (pixels) => {
-  const grid = ensurePixelGrid(pixels);
-  if (!grid) return [];
-  return grid.map((row) => [...row].reverse());
+  const grid2 = ensurePixelGrid(pixels);
+  if (!grid2) return [];
+  return grid2.map((row) => [...row].reverse());
 };
 var flipVertical = (pixels) => {
-  const grid = ensurePixelGrid(pixels);
-  if (!grid) return [];
-  return [...grid].reverse();
+  const grid2 = ensurePixelGrid(pixels);
+  if (!grid2) return [];
+  return [...grid2].reverse();
 };
 var rotate90 = (pixels) => {
-  const grid = ensurePixelGrid(pixels);
-  if (!grid || grid.length === 0) return [];
-  const rows = grid.length;
-  const cols = Math.max(0, ...grid.map((r) => r.length));
+  const grid2 = ensurePixelGrid(pixels);
+  if (!grid2 || grid2.length === 0) return [];
+  const rows = grid2.length;
+  const cols = Math.max(0, ...grid2.map((r) => r.length));
   if (cols === 0) return [];
   return Array.from(
     { length: cols },
-    (_, c) => Array.from({ length: rows }, (__, r) => grid[rows - 1 - r]?.[c] ?? null)
+    (_, c) => Array.from({ length: rows }, (__, r) => grid2[rows - 1 - r]?.[c] ?? null)
   );
 };
 var BAYER_4x4 = [
@@ -5729,7 +5778,9 @@ var frame = (block, opts = {}) => {
     paddingX,
     topChar = "\u2500",
     bottomChar,
-    title
+    title,
+    titleAlign = "center"
+    // v1.3.3
   } = opts;
   const safePadY = Math.max(0, Math.floor(paddingY ?? padding));
   const safePadX = Math.max(0, Math.floor(paddingX ?? padding));
@@ -5750,8 +5801,18 @@ var frame = (block, opts = {}) => {
   }
   let topLine;
   if (titleStr.length > 0 && titleW < innerW) {
-    const before = Math.floor((innerW - titleW) / 2);
-    const after = innerW - titleW - before;
+    let before;
+    let after;
+    if (titleAlign === "left") {
+      before = 1;
+      after = innerW - titleW - before;
+    } else if (titleAlign === "right") {
+      after = 1;
+      before = innerW - titleW - after;
+    } else {
+      before = Math.floor((innerW - titleW) / 2);
+      after = innerW - titleW - before;
+    }
     topLine = safeTop.repeat(before) + titleStr + safeTop.repeat(after);
   } else {
     topLine = safeTop.repeat(innerW);
@@ -5772,12 +5833,54 @@ var frame = (block, opts = {}) => {
   out.push(bottomLine);
   return out.join("\n");
 };
+var grid = (blocks, opts) => {
+  if (!Array.isArray(blocks) || blocks.length === 0) return "";
+  if (!opts || typeof opts !== "object") return "";
+  const columns2 = Math.max(1, Math.floor(opts.columns ?? 1));
+  const gapX = Math.max(0, Math.floor(opts.gapX ?? 1));
+  const gapY = Math.max(0, Math.floor(opts.gapY ?? 0));
+  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));
+  }
+  let widths = null;
+  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;
+        }
+      }
+    }
+  }
+  const renderedRows = rows.map((row) => {
+    const padded = [];
+    for (let c = 0; c < columns2; c++) {
+      padded.push(row[c] ?? "");
+    }
+    return vsplit(padded, {
+      gap: gapX,
+      align: alignY,
+      widths
+    });
+  });
+  return hsplit(renderedRows, { gap: gapY, align: alignX });
+};
 var panels = {
   vsplit,
   hsplit,
   // v1.3.1
   center: center2,
-  frame
+  frame,
+  // v1.3.3
+  grid
 };
 
 // src/json/index.ts
@@ -5797,11 +5900,12 @@ var _truncString = (s, maxLength) => {
   return s.slice(0, maxLength - 3) + "...";
 };
 var _formatPrimitive = (value, opts) => {
-  const { useColor, maxStringLength } = opts;
+  const { useColor, maxStringLength, mode } = opts;
   if (value === null) {
     return _c("null", COLORS.null, useColor);
   }
   if (value === void 0) {
+    if (mode === "json") return _c("null", COLORS.null, useColor);
     return _c("undefined", COLORS.null, useColor);
   }
   if (typeof value === "string") {
@@ -5810,8 +5914,12 @@ var _formatPrimitive = (value, opts) => {
     return _c(quoted, COLORS.string, useColor);
   }
   if (typeof value === "number") {
-    if (Number.isNaN(value)) return _c("NaN", COLORS.number, useColor);
+    if (Number.isNaN(value)) {
+      if (mode === "json") return _c("null", COLORS.null, useColor);
+      return _c("NaN", COLORS.number, useColor);
+    }
     if (!Number.isFinite(value)) {
+      if (mode === "json") return _c("null", COLORS.null, useColor);
       return _c(value > 0 ? "Infinity" : "-Infinity", COLORS.number, useColor);
     }
     return _c(String(value), COLORS.number, useColor);
@@ -5820,16 +5928,23 @@ var _formatPrimitive = (value, opts) => {
     return _c(String(value), COLORS.boolean, useColor);
   }
   if (typeof value === "bigint") {
+    if (mode === "json") {
+      const big2 = value;
+      const asNum = Number(big2);
+      if (Number.isSafeInteger(asNum) && BigInt(asNum) === big2) {
+        return _c(String(asNum), COLORS.number, useColor);
+      }
+      return _c(JSON.stringify(String(big2)), COLORS.string, useColor);
+    }
     return _c(`${value}n`, COLORS.number, useColor);
   }
   if (typeof value === "function") {
+    if (mode === "json") return _c("null", COLORS.null, useColor);
     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);
+  if (mode === "json") return _c("null", COLORS.null, useColor);
+  return _c(value.toString(), COLORS.comment, useColor);
 };
 var _renderValue = (value, depth, config) => {
   const {
@@ -5840,15 +5955,56 @@ var _renderValue = (value, depth, config) => {
     useColor,
     seen,
     sortKeys,
-    inlineArrayMaxLength
+    inlineArrayMaxLength,
+    mode
   } = config;
   if (value === null || typeof value !== "object") {
-    return _formatPrimitive(value, { useColor, maxStringLength });
+    return _formatPrimitive(value, { useColor, maxStringLength, mode });
   }
   if (seen.has(value)) {
+    if (mode === "json") {
+      throw new TypeError("Cannot serialize circular reference to JSON");
+    }
     return _c("[Circular]", COLORS.comment, useColor);
   }
   seen.add(value);
+  if (value instanceof Date) {
+    const iso = value.toISOString();
+    if (mode === "json") {
+      return _c(JSON.stringify(iso), COLORS.string, useColor);
+    }
+    return _c(`Date(${iso})`, COLORS.comment, useColor);
+  }
+  if (value instanceof Map) {
+    if (mode === "json") {
+      const obj = {};
+      for (const [k, v] of value) {
+        if (typeof k === "string") obj[k] = v;
+        else obj[String(k)] = v;
+      }
+      return _renderValue(obj, depth, config);
+    }
+    const entries2 = Array.from(value);
+    const sizeLabel = _c(`Map(${entries2.length})`, COLORS.comment, useColor);
+    if (entries2.length === 0) {
+      return `${sizeLabel} ${_c("{}", COLORS.bracket, useColor)}`;
+    }
+    if (depth >= maxDepth - 1 && depth > 0) {
+      return `${sizeLabel} ${_c("{...}", COLORS.bracket, useColor)}`;
+    }
+    return `${sizeLabel} ${_renderValue(entries2, depth, config)}`;
+  }
+  if (value instanceof Set) {
+    if (mode === "json") {
+      return _renderValue(Array.from(value), depth, config);
+    }
+    const arr = Array.from(value);
+    const sizeLabel = _c(`Set(${arr.length})`, COLORS.comment, useColor);
+    if (arr.length === 0) {
+      return `${sizeLabel} ${_c("[]", COLORS.bracket, useColor)}`;
+    }
+    return `${sizeLabel} ${_renderValue(arr, depth, config)}`;
+  }
   if (depth >= maxDepth) {
     if (Array.isArray(value)) {
       return _c("[", COLORS.bracket, useColor) + _c("...", COLORS.comment, useColor) + _c("]", COLORS.bracket, useColor);
@@ -5867,7 +6023,7 @@ var _renderValue = (value, depth, config) => {
         const displayCount2 = Math.min(value.length, maxItems);
         const inlineItems = [];
         for (let i = 0; i < displayCount2; i++) {
-          inlineItems.push(_formatPrimitive(value[i], { useColor, maxStringLength }));
+          inlineItems.push(_formatPrimitive(value[i], { useColor, maxStringLength, mode }));
         }
         if (value.length > maxItems) {
           const remaining = value.length - maxItems;
@@ -5893,6 +6049,12 @@ var _renderValue = (value, depth, config) => {
     return _c("[", COLORS.bracket, useColor) + "\n" + items.join(",\n") + "\n" + closePad + _c("]", COLORS.bracket, useColor);
   }
   let keys = Object.keys(value);
+  if (mode === "json") {
+    keys = keys.filter((k) => {
+      const v = value[k];
+      return typeof v !== "function" && typeof v !== "symbol" && v !== void 0;
+    });
+  }
   if (keys.length === 0) {
     return _c("{}", COLORS.bracket, useColor);
   }
@@ -5921,14 +6083,17 @@ var pretty = (value, opts = {}) => {
     maxStringLength = Infinity,
     // v1.3.1
     sortKeys = false,
-    inlineArrayMaxLength = 60
+    inlineArrayMaxLength = 60,
+    // v1.3.3
+    mode = "display"
   } = 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();
+  const safeMode = mode === "json" ? "json" : "display";
+  const useColor = safeMode === "json" ? false : colors && !isNoColor();
   return _renderValue(value, 0, {
     indent: safeIndent,
     maxDepth: safeMaxDepth,
@@ -5937,7 +6102,8 @@ var pretty = (value, opts = {}) => {
     useColor,
     seen: /* @__PURE__ */ new WeakSet(),
     sortKeys: Boolean(sortKeys),
-    inlineArrayMaxLength: safeInlineMax
+    inlineArrayMaxLength: safeInlineMax,
+    mode: safeMode
   });
 };
 var json = {
@@ -6231,6 +6397,7 @@ var index_default = ansimax;
   gradientColor,
   gradientRect,
   graphemes,
+  grid,
   hasFont,
   hexToRgb,
   hideCursor,