ansimax 1.3.0 → 1.3.1

package/CHANGELOG.md

@@ -3,6 +3,128 @@
 All notable changes to **ansimax** are documented in this file.
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [1.3.1] — Polish for panels + json
+
+Patch release improving the two modules introduced in v1.3.0 — adds layout
+helpers, JSON readability options, and tests. No breaking changes.
+
+### Added — `panels.center(block, opts)`
+
+Center a multi-line block horizontally (and optionally vertically) within
+a fixed width/height. Useful for centering boxes, banners, or any pre-rendered
+block in a known terminal width.
+
+```js
+import { panels, ascii } from 'ansimax';
+
+// Horizontal centering only
+console.log(panels.center('Hello!', { width: 30 }));
+//   "            Hello!            "
+
+// Vertical too — content fits in 5 rows
+console.log(panels.center('X', { width: 5, height: 5, align: 'center' }));
+
+// Combine with box for a centered card
+console.log(panels.center(ascii.box('Hello'), { width: 80 }));
+```
+
+Exported as `centerBlock` from the main barrel (to avoid colliding with the
+existing `center` text helper). The namespaced form `panels.center` works
+identically.
+
+### Added — `panels.frame(block, opts)`
+
+Lighter alternative to `ascii.box`: draws only top/bottom decorative rules
+(not full sides). Supports a centered title, padding, and custom characters.
+
+```js
+import { panels } from 'ansimax';
+
+// Simple rules
+console.log(panels.frame('Hello world!'));
+// ─────────────
+// Hello world!
+// ─────────────
+
+// With title + padding
+console.log(panels.frame('Body content\nMore content', {
+  title: 'Header',
+  padding: 1,
+}));
+// ───── Header ─────
+//
+//  Body content
+//  More content
+//
+// ──────────────────
+
+// Custom decoration chars
+console.log(panels.frame('Important!', {
+  topChar: '═',
+  padding: 2,
+}));
+```
+
+### Added — `json.pretty` option `sortKeys`
+
+Sort object keys alphabetically for deterministic output. Useful for diffs,
+snapshots, and visual scanning of large objects.
+
+```js
+import { json } from 'ansimax';
+
+console.log(json.pretty({ zebra: 1, apple: 2, mango: 3 }, { sortKeys: true }));
+// {
+//   "apple": 2,
+//   "mango": 3,
+//   "zebra": 1
+// }
+```
+
+Recursive — applies to all nested objects. Default `false` (preserves
+insertion order).
+
+### Added — `json.pretty` option `inlineArrayMaxLength`
+
+Arrays of primitives now render on a single line when their rendered length
+is short enough (default threshold: 60 visible characters). This improves
+readability significantly for typical configs:
+
+```js
+// Before v1.3.1:
+{
+  "tags": [
+    "frontend",
+    "react",
+    "typescript"
+  ]
+}
+
+// In v1.3.1 (default behavior):
+{
+  "tags": ["frontend", "react", "typescript"]
+}
+```
+
+Arrays containing objects/arrays never inline regardless of length. Set
+`inlineArrayMaxLength: 0` to restore the v1.3.0 always-expand behavior.
+
+### Improved — Tests
+
+- `+11` tests for `panels.center` + `panels.frame`
+- `+15` tests for `json.pretty` `sortKeys` + `inlineArrayMaxLength`
+- Total tests: 2,000+ → **~2,026** across 18 suites
+
+### Notes
+
+- No runtime dependencies — still zero
+- No breaking changes — drop-in replacement for `1.3.0`
+- `panels.center` is exposed as `centerBlock` at the top level to avoid
+  conflict with the existing `center` text helper; both `panels.center` and
+  `centerBlock` reference the same function
+
+---
+
 ## [1.3.0] — Phase 4 progress: Panels + JSON pretty-print
 
 Minor release adding **split layout primitives** and **JSON pretty-printing**.

package/README.es.md

@@ -7,7 +7,7 @@
 _Colores • Gradientes • Animaciones • ASCII Art • Pixel Art • Árboles • Componentes • Temas_
 
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg?style=flat-square)](LICENSE)
-[![npm](https://img.shields.io/badge/npm-v1.3.0-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
+[![npm](https://img.shields.io/badge/npm-v1.3.1-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6.svg?style=flat-square)](tsconfig.json)
 [![Coverage](https://img.shields.io/badge/coverage-98%25-brightgreen.svg?style=flat-square)](#testing)
 [![Tests](https://img.shields.io/badge/tests-2000%2B%20passing-brightgreen.svg?style=flat-square)](#testing)
@@ -445,7 +445,7 @@ console.log(components.table([
   ['loaders',    color.green('● listo'),  '100%'],
 ], { borderStyle: 'rounded' }));
 
-console.log(components.badge('VERSION', 'v1.3.0'));
+console.log(components.badge('VERSION', 'v1.3.1'));
 console.log(components.badge('BUILD',   'passing'));
 ```
 
@@ -1006,6 +1006,35 @@ ansimax/
 
 ## 📝 Changelog
 
+### v1.3.1 — Pulido de panels + json
+
+Release patch que mejora los módulos de v1.3.0 con quality-of-life:
+
+- 🎯 **`panels.center(block, opts)`** — centra un block horizontalmente (y opcionalmente verticalmente) en un ancho conocido
+- 🖼️ **`panels.frame(block, opts)`** — alternativa más ligera a `ascii.box`: solo top/bottom con title + padding opcionales
+- 📋 **`json.pretty` opción `sortKeys`** — orden alfabético de keys para diffs deterministas
+- 📐 **`json.pretty` opción `inlineArrayMaxLength`** — arrays cortos de primitivos ahora se renderizan como `[1, 2, 3]` en una línea (threshold default: 60 chars)
+- 🧪 **+26 tests** entre panels + json
+
+```js
+import { panels, json } from 'ansimax';
+
+// Centrar un box dentro de la terminal
+console.log(panels.center(ascii.box('Hello'), { width: 80 }));
+
+// Frame decorativo más ligero
+console.log(panels.frame('Body', { title: 'Header', padding: 1 }));
+
+// Sorted, con inline arrays
+console.log(json.pretty({ zebra: [1, 2, 3], apple: 'A' }, { sortKeys: true }));
+// {
+//   "apple": "A",
+//   "zebra": [1, 2, 3]
+// }
+```
+
+Drop-in replacement para `1.3.0`.
+
 ### v1.3.0 — Avance Fase 4: Panels + JSON pretty-print
 
 Release minor que añade dos nuevos módulos top-level — split layouts y pretty-print de JSON:

package/README.md

@@ -7,7 +7,7 @@
 _Colors • Gradients • Animations • ASCII Art • Pixel Art • Trees • Components • Themes_
 
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg?style=flat-square)](LICENSE)
-[![npm](https://img.shields.io/badge/npm-v1.3.0-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
+[![npm](https://img.shields.io/badge/npm-v1.3.1-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6.svg?style=flat-square)](tsconfig.json)
 [![Coverage](https://img.shields.io/badge/coverage-98%25-brightgreen.svg?style=flat-square)](#testing)
 [![Tests](https://img.shields.io/badge/tests-2000%2B%20passing-brightgreen.svg?style=flat-square)](#testing)
@@ -445,7 +445,7 @@ console.log(components.table([
   ['loaders',    color.green('● ready'),  '100%'],
 ], { borderStyle: 'rounded' }));
 
-console.log(components.badge('VERSION', 'v1.3.0'));
+console.log(components.badge('VERSION', 'v1.3.1'));
 console.log(components.badge('BUILD',   'passing'));
 ```
 
@@ -1006,6 +1006,35 @@ ansimax/
 
 ## 📝 Changelog
 
+### v1.3.1 — Polish for panels + json
+
+Patch release improving the modules from v1.3.0 with quality-of-life additions:
+
+- 🎯 **`panels.center(block, opts)`** — center a block horizontally (and optionally vertically) in a known width
+- 🖼️ **`panels.frame(block, opts)`** — lighter alternative to `ascii.box`: top/bottom rules only, with optional title + padding
+- 📋 **`json.pretty` option `sortKeys`** — alphabetic key order for deterministic diffs
+- 📐 **`json.pretty` option `inlineArrayMaxLength`** — short arrays of primitives now render as `[1, 2, 3]` on one line (default threshold: 60 chars)
+- 🧪 **+26 tests** across panels + json modules
+
+```js
+import { panels, json } from 'ansimax';
+
+// Center a box inside the terminal
+console.log(panels.center(ascii.box('Hello'), { width: 80 }));
+
+// Lighter decorative frame
+console.log(panels.frame('Body', { title: 'Header', padding: 1 }));
+
+// Sorted, with inline arrays
+console.log(json.pretty({ zebra: [1, 2, 3], apple: 'A' }, { sortKeys: true }));
+// {
+//   "apple": "A",
+//   "zebra": [1, 2, 3]
+// }
+```
+
+Drop-in replacement for `1.3.0`.
+
 ### v1.3.0 — Phase 4 progress: Panels + JSON pretty-print
 
 Minor release adding two new top-level modules — split layouts and JSON pretty-printing:

package/dist/index.d.mts

@@ -359,7 +359,7 @@ declare const sliceAnsi: (str: string, start: number, end?: number) => string;
 declare const truncateAnsi: (str: string, width: number, ellipsis?: string) => string;
 declare const padEnd: (str: string, width: number, ch?: string) => string;
 declare const padStart: (str: string, width: number, ch?: string) => string;
-declare const center: (str: string, width: number, ch?: string) => string;
+declare const center$1: (str: string, width: number, ch?: string) => string;
 /** Repeats a string until its visible length reaches the target width. */
 declare const repeatVisible: (str: string, width: number) => string;
 /**
@@ -2028,9 +2028,120 @@ declare const vsplit: (blocks: string[], opts?: VsplitOptions) => string;
  * ```
  */
 declare const hsplit: (blocks: string[], opts?: HsplitOptions) => string;
+interface CenterOptions {
+    /** Total width to center within. Required. */
+    width: number;
+    /**
+     * Vertical alignment if `height` is also specified.
+     * Default `'start'`.
+     */
+    align?: Alignment;
+    /**
+     * Total height to fit the block into. Optional — if omitted, only
+     * horizontal centering is applied.
+     */
+    height?: number;
+}
+/**
+ * Center a multi-line block horizontally (and optionally vertically)
+ * within a given width/height. Each line is padded with spaces on both
+ * sides; ANSI escapes are preserved.
+ *
+ * @example horizontal centering only
+ * ```js
+ * import { panels } from 'ansimax';
+ *
+ * console.log(panels.center('Hello!', { width: 30 }));
+ * //                "            Hello!            "
+ * ```
+ *
+ * @example multi-line centered in a fixed area
+ * ```js
+ * console.log(panels.center('Line 1\nLine 2\nLine 3', {
+ *   width: 30,
+ *   height: 7,
+ *   align: 'center',
+ * }));
+ * ```
+ *
+ * @example combined with box for a centered card
+ * ```js
+ * import { ascii, panels } from 'ansimax';
+ *
+ * console.log(panels.center(ascii.box('Hello'), { width: 80 }));
+ * // Box appears centered in a 80-wide terminal
+ * ```
+ */
+declare const center: (block: string, opts: CenterOptions) => string;
+interface FrameOptions {
+    /**
+     * Padding (in spaces) between the block content and the inner edge of
+     * the frame. Default `0`.
+     */
+    padding?: number;
+    /**
+     * Padding above + below the block. If unset, falls back to `padding`.
+     */
+    paddingY?: number;
+    /**
+     * Padding left + right of the block. If unset, falls back to `padding`.
+     */
+    paddingX?: number;
+    /**
+     * Top decoration character — e.g. `'─'`, `'═'`, `'━'`, `'·'`.
+     * Default `'─'`.
+     */
+    topChar?: string;
+    /**
+     * Bottom decoration character. Default same as `topChar`.
+     */
+    bottomChar?: string;
+    /**
+     * Optional title shown centered in the top edge.
+     */
+    title?: string;
+}
+/**
+ * Add decorative top/bottom rule lines around a block (lighter than `ascii.box`
+ * which draws four sides). Useful for visual separation without full borders.
+ *
+ * @example simple top/bottom rules
+ * ```js
+ * console.log(panels.frame('Hello world!'));
+ * // ─────────────
+ * // Hello world!
+ * // ─────────────
+ * ```
+ *
+ * @example with title and padding
+ * ```js
+ * console.log(panels.frame('Body content\nMore content', {
+ *   title: 'Header',
+ *   padding: 1,
+ * }));
+ * // ───── Header ─────
+ * //
+ * //  Body content
+ * //  More content
+ * //
+ * // ──────────────────
+ * ```
+ *
+ * @example custom decorations
+ * ```js
+ * console.log(panels.frame('Important!', {
+ *   topChar: '═',
+ *   bottomChar: '═',
+ *   padding: 2,
+ * }));
+ * ```
+ */
+declare const frame: (block: string, opts?: FrameOptions) => 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;
 };
 
 /**
@@ -2071,6 +2182,23 @@ interface PrettyOptions {
      * Maximum string length before truncation with ellipsis. Default `Infinity`.
      */
     maxStringLength?: number;
+    /**
+     * Sort object keys alphabetically. Useful for deterministic diffs (e.g.,
+     * comparing two JSON snapshots) and for visual scanning of large objects.
+     * Default `false` (insertion order preserved).
+     *
+     * @since 1.3.1
+     */
+    sortKeys?: boolean;
+    /**
+     * Arrays of primitives shorter than this character width (in their
+     * rendered form) are displayed on a single line: `[1, 2, 3]` instead of
+     * three lines. Nested objects/arrays never inline regardless of size.
+     * Set to `0` to disable inlining. Default `60`.
+     *
+     * @since 1.3.1
+     */
+    inlineArrayMaxLength?: number;
 }
 /**
  * Pretty-print a JavaScript value with colored output suitable for
@@ -2288,4 +2416,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 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 };
+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 };

package/dist/index.d.ts

@@ -359,7 +359,7 @@ declare const sliceAnsi: (str: string, start: number, end?: number) => string;
 declare const truncateAnsi: (str: string, width: number, ellipsis?: string) => string;
 declare const padEnd: (str: string, width: number, ch?: string) => string;
 declare const padStart: (str: string, width: number, ch?: string) => string;
-declare const center: (str: string, width: number, ch?: string) => string;
+declare const center$1: (str: string, width: number, ch?: string) => string;
 /** Repeats a string until its visible length reaches the target width. */
 declare const repeatVisible: (str: string, width: number) => string;
 /**
@@ -2028,9 +2028,120 @@ declare const vsplit: (blocks: string[], opts?: VsplitOptions) => string;
  * ```
  */
 declare const hsplit: (blocks: string[], opts?: HsplitOptions) => string;
+interface CenterOptions {
+    /** Total width to center within. Required. */
+    width: number;
+    /**
+     * Vertical alignment if `height` is also specified.
+     * Default `'start'`.
+     */
+    align?: Alignment;
+    /**
+     * Total height to fit the block into. Optional — if omitted, only
+     * horizontal centering is applied.
+     */
+    height?: number;
+}
+/**
+ * Center a multi-line block horizontally (and optionally vertically)
+ * within a given width/height. Each line is padded with spaces on both
+ * sides; ANSI escapes are preserved.
+ *
+ * @example horizontal centering only
+ * ```js
+ * import { panels } from 'ansimax';
+ *
+ * console.log(panels.center('Hello!', { width: 30 }));
+ * //                "            Hello!            "
+ * ```
+ *
+ * @example multi-line centered in a fixed area
+ * ```js
+ * console.log(panels.center('Line 1\nLine 2\nLine 3', {
+ *   width: 30,
+ *   height: 7,
+ *   align: 'center',
+ * }));
+ * ```
+ *
+ * @example combined with box for a centered card
+ * ```js
+ * import { ascii, panels } from 'ansimax';
+ *
+ * console.log(panels.center(ascii.box('Hello'), { width: 80 }));
+ * // Box appears centered in a 80-wide terminal
+ * ```
+ */
+declare const center: (block: string, opts: CenterOptions) => string;
+interface FrameOptions {
+    /**
+     * Padding (in spaces) between the block content and the inner edge of
+     * the frame. Default `0`.
+     */
+    padding?: number;
+    /**
+     * Padding above + below the block. If unset, falls back to `padding`.
+     */
+    paddingY?: number;
+    /**
+     * Padding left + right of the block. If unset, falls back to `padding`.
+     */
+    paddingX?: number;
+    /**
+     * Top decoration character — e.g. `'─'`, `'═'`, `'━'`, `'·'`.
+     * Default `'─'`.
+     */
+    topChar?: string;
+    /**
+     * Bottom decoration character. Default same as `topChar`.
+     */
+    bottomChar?: string;
+    /**
+     * Optional title shown centered in the top edge.
+     */
+    title?: string;
+}
+/**
+ * Add decorative top/bottom rule lines around a block (lighter than `ascii.box`
+ * which draws four sides). Useful for visual separation without full borders.
+ *
+ * @example simple top/bottom rules
+ * ```js
+ * console.log(panels.frame('Hello world!'));
+ * // ─────────────
+ * // Hello world!
+ * // ─────────────
+ * ```
+ *
+ * @example with title and padding
+ * ```js
+ * console.log(panels.frame('Body content\nMore content', {
+ *   title: 'Header',
+ *   padding: 1,
+ * }));
+ * // ───── Header ─────
+ * //
+ * //  Body content
+ * //  More content
+ * //
+ * // ──────────────────
+ * ```
+ *
+ * @example custom decorations
+ * ```js
+ * console.log(panels.frame('Important!', {
+ *   topChar: '═',
+ *   bottomChar: '═',
+ *   padding: 2,
+ * }));
+ * ```
+ */
+declare const frame: (block: string, opts?: FrameOptions) => 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;
 };
 
 /**
@@ -2071,6 +2182,23 @@ interface PrettyOptions {
      * Maximum string length before truncation with ellipsis. Default `Infinity`.
      */
     maxStringLength?: number;
+    /**
+     * Sort object keys alphabetically. Useful for deterministic diffs (e.g.,
+     * comparing two JSON snapshots) and for visual scanning of large objects.
+     * Default `false` (insertion order preserved).
+     *
+     * @since 1.3.1
+     */
+    sortKeys?: boolean;
+    /**
+     * Arrays of primitives shorter than this character width (in their
+     * rendered form) are displayed on a single line: `[1, 2, 3]` instead of
+     * three lines. Nested objects/arrays never inline regardless of size.
+     * Set to `0` to disable inlining. Default `60`.
+     *
+     * @since 1.3.1
+     */
+    inlineArrayMaxLength?: number;
 }
 /**
  * Pretty-print a JavaScript value with colored output suitable for
@@ -2288,4 +2416,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 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 };
+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 };