ansimax 1.2.3 → 1.2.4

package/CHANGELOG.md

@@ -3,6 +3,76 @@
 All notable changes to **ansimax** are documented in this file.
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [1.2.4] — Gradient utilities + inspectability
+
+Patch release adding gradient inspection and manipulation utilities.
+No breaking changes — `createGradient()` callers from 1.2.3 continue
+to work, but now have access to metadata.
+
+### Added — `ReusableGradient` metadata
+
+`createGradient()` now returns a `ReusableGradient` — still callable
+like before, but with frozen metadata for inspection and debugging:
+
+```ts
+const fire = createGradient(['#ff5555', '#ffb86c', '#f1fa8c'], {
+  easing: 'ease-in',
+});
+
+// All still callable
+console.log(fire('hello'));
+
+// New: read-only inspection
+fire.stops;            // → ['#ff5555', '#ffb86c', '#f1fa8c']
+fire.resolvedStops;    // → [{r:255,g:85,b:85}, {r:255,g:184,b:108}, ...]
+fire.defaultOptions;   // → { easing: 'ease-in' }
+```
+
+All three properties are frozen — attempting to mutate them throws in
+strict mode and silently fails in sloppy mode.
+
+### Added — `reverseGradient()` helper
+
+Returns a new gradient with stops in reverse order. Works with both
+plain arrays and `ReusableGradient` instances. Default options are
+preserved when reversing a `ReusableGradient`:
+
+```ts
+const fire = createGradient(['#ff5555', '#ffb86c', '#f1fa8c']);
+const ice  = reverseGradient(fire);  // → '#f1fa8c' → '#ffb86c' → '#ff5555'
+
+console.log(fire('warm side'));
+console.log(ice('cool side'));
+
+// Also works with plain arrays
+reverseGradient(['#f00', '#0f0', '#00f']);  // → ['#00f', '#0f0', '#f00']
+```
+
+The original array / gradient is never mutated.
+
+### Added — `presets` alias (canonical name)
+
+Previously `presets` was exported only as `colorPresets`. Many users
+referenced `presets` based on docs and got `ReferenceError`. Now both
+names point to the same object:
+
+```ts
+import { presets, colorPresets } from 'ansimax';
+
+presets === colorPresets;  // → true
+```
+
+`colorPresets` remains for backwards compatibility; new code can use
+either name.
+
+### Notes
+
+- Coverage holds steady at ~98%.
+- No new runtime dependencies — still zero.
+- All 1892 + 22 new tests pass.
+
+---
+
 ## [1.2.3] — Gradient factory + performance
 
 Patch release adding a new performance-oriented API and refinements. No

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.2.3-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
+[![npm](https://img.shields.io/badge/npm-v1.2.4-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-1700%2B%20passing-brightgreen.svg?style=flat-square)](#testing)
@@ -263,7 +263,7 @@ console.log(gradientRect({
 ### Gradientes reusables (v1.2.3)
 
 ```ts
-import { createGradient, ascii } from 'ansimax';
+import { createGradient, reverseGradient, ascii } from 'ansimax';
 
 // Pre-resuelve los stops de hex una vez — significativamente más rápido para uso repetido
 const fire = createGradient(['#ff5555', '#ffb86c', '#f1fa8c']);
@@ -275,6 +275,14 @@ console.log(fire('Tercera línea'));
 // Úsalo como colorFn para banners — misma firma de ColorFn
 console.log(ascii.banner('FIRE', { colorFn: fire }));
 
+// v1.2.4: inspecciona metadata
+console.log('Stops:', fire.stops);             // → ['#ff5555', '#ffb86c', '#f1fa8c']
+console.log('Resolved:', fire.resolvedStops);  // → [{r:255,g:85,b:85}, ...]
+
+// v1.2.4: invierte un gradiente (preserva las opciones por defecto)
+const ice = reverseGradient(fire);
+console.log(ice('Lado frío'));
+
 // Las opciones por-llamada aún funcionan — perfecto para animación
 for (let p = 0; p < 1; p += 0.05) {
   process.stdout.write('\r' + fire('fluyendo', { phase: p }));
@@ -357,7 +365,7 @@ console.log(components.table([
   ['loaders',    color.green('● listo'),  '100%'],
 ], { borderStyle: 'rounded' }));
 
-console.log(components.badge('VERSION', 'v1.2.3'));
+console.log(components.badge('VERSION', 'v1.2.4'));
 console.log(components.badge('BUILD',   'passing'));
 ```
 
@@ -759,6 +767,27 @@ ansimax/
 
 ## 📝 Changelog
 
+### v1.2.4 — Utilidades de gradiente + inspectabilidad
+
+Release patch añadiendo metadata de inspección y un helper `reverseGradient()`:
+
+- 🔍 **`ReusableGradient` expone `.stops`, `.resolvedStops`, `.defaultOptions`** — todos congelados, todos de solo lectura
+- 🔄 **Helper `reverseGradient()`** — invierte el orden de stops de un gradiente (funciona con arrays o `ReusableGradient`)
+- 🎯 **`presets` exportado con su nombre canónico** — junto al alias existente `colorPresets`
+
+```ts
+import { createGradient, reverseGradient } from 'ansimax';
+
+const fire = createGradient(['#ff5555', '#ffb86c', '#f1fa8c']);
+const ice  = reverseGradient(fire);
+
+console.log(fire.stops);  // ['#ff5555', '#ffb86c', '#f1fa8c']  — read-only
+console.log(fire('cálido'));
+console.log(ice('frío'));
+```
+
+Drop-in replacement para `1.2.3`.
+
 ### v1.2.3 — Factory de gradientes + performance
 
 Release patch añadiendo una API orientada a performance:

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.2.3-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
+[![npm](https://img.shields.io/badge/npm-v1.2.4-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-1700%2B%20passing-brightgreen.svg?style=flat-square)](#testing)
@@ -263,7 +263,7 @@ console.log(gradientRect({
 ### Reusable Gradients (v1.2.3)
 
 ```ts
-import { createGradient, ascii } from 'ansimax';
+import { createGradient, reverseGradient, ascii } from 'ansimax';
 
 // Pre-resolve hex stops once — significantly faster for repeated use
 const fire = createGradient(['#ff5555', '#ffb86c', '#f1fa8c']);
@@ -275,6 +275,14 @@ console.log(fire('Third line'));
 // Use as a colorFn for banners — same ColorFn signature
 console.log(ascii.banner('FIRE', { colorFn: fire }));
 
+// v1.2.4: inspect metadata
+console.log('Stops:', fire.stops);             // → ['#ff5555', '#ffb86c', '#f1fa8c']
+console.log('Resolved:', fire.resolvedStops);  // → [{r:255,g:85,b:85}, ...]
+
+// v1.2.4: reverse a gradient (preserves default options)
+const ice = reverseGradient(fire);
+console.log(ice('Cool side'));
+
 // Per-call options still work — perfect for animation
 for (let p = 0; p < 1; p += 0.05) {
   process.stdout.write('\r' + fire('flowing', { phase: p }));
@@ -357,7 +365,7 @@ console.log(components.table([
   ['loaders',    color.green('● ready'),  '100%'],
 ], { borderStyle: 'rounded' }));
 
-console.log(components.badge('VERSION', 'v1.2.3'));
+console.log(components.badge('VERSION', 'v1.2.4'));
 console.log(components.badge('BUILD',   'passing'));
 ```
 
@@ -759,6 +767,27 @@ ansimax/
 
 ## 📝 Changelog
 
+### v1.2.4 — Gradient utilities + inspectability
+
+Patch release adding inspection metadata and a `reverseGradient()` helper:
+
+- 🔍 **`ReusableGradient` exposes `.stops`, `.resolvedStops`, `.defaultOptions`** — all frozen, all read-only
+- 🔄 **`reverseGradient()` helper** — flips a gradient's stop order (works with arrays or `ReusableGradient`)
+- 🎯 **`presets` exported as canonical name** — alongside the existing `colorPresets` alias
+
+```ts
+import { createGradient, reverseGradient } from 'ansimax';
+
+const fire = createGradient(['#ff5555', '#ffb86c', '#f1fa8c']);
+const ice  = reverseGradient(fire);
+
+console.log(fire.stops);  // ['#ff5555', '#ffb86c', '#f1fa8c']  — read-only
+console.log(fire('warm'));
+console.log(ice('cool'));
+```
+
+Drop-in replacement for `1.2.3`.
+
 ### v1.2.3 — Gradient factory + performance
 
 Patch release adding a performance-oriented API:

package/dist/index.d.mts

@@ -622,7 +622,47 @@ declare const gradient: (text: unknown, stops: string[] | null | undefined, opts
  * }
  * ```
  */
-declare const createGradient: (stops: string[] | null | undefined, defaultOpts?: Omit<GradientOptions, "phase">) => ((text: unknown, opts?: GradientOptions) => string);
+/**
+ * The function returned by `createGradient()`. Callable just like `gradient()`,
+ * but also exposes metadata for inspection and chaining.
+ */
+interface ReusableGradient {
+    /** Apply the gradient to text. */
+    (text: unknown, opts?: GradientOptions): string;
+    /** The original hex stops that were passed to `createGradient()`. */
+    readonly stops: readonly string[];
+    /** The resolved RGB stops (after filtering invalid hex). */
+    readonly resolvedStops: readonly Readonly<RGB>[];
+    /** Default options frozen at factory time. */
+    readonly defaultOptions: Readonly<Omit<GradientOptions, 'phase'>>;
+}
+declare const createGradient: (stops: string[] | null | undefined, defaultOpts?: Omit<GradientOptions, "phase">) => ReusableGradient;
+/**
+ * Return a new gradient with the stops reversed. Useful for symmetric
+ * effects (e.g. fade in / fade out) or to flip an existing palette.
+ *
+ * Accepts either:
+ * - A `ReusableGradient` returned from `createGradient()` — returns a new one
+ * - An array of hex stops — returns a new array with the order flipped
+ *
+ * @example
+ * ```ts
+ * const fire = createGradient(['#ff5555', '#ffb86c', '#f1fa8c']);
+ * const ice  = reverseGradient(fire);  // ReusableGradient with reversed stops
+ *
+ * console.log(fire('warm side'));
+ * console.log(ice('cool side'));
+ * ```
+ *
+ * @example with plain stops
+ * ```ts
+ * const stops = ['#ff0000', '#00ff00', '#0000ff'];
+ * const reversed = reverseGradient(stops);
+ * // → ['#0000ff', '#00ff00', '#ff0000']
+ * ```
+ */
+declare function reverseGradient(grad: ReusableGradient): ReusableGradient;
+declare function reverseGradient(stops: string[]): string[];
 declare const rainbow: ColorFn;
 interface AnimateGradientOptions {
     /** Total animation duration in ms. Default `2000`. */
@@ -1767,4 +1807,4 @@ declare const ansimax: {
     configure: (opts?: AnsimaxConfig, meta?: ConfigureOptions) => void;
 };
 
-export { type AnimateGradientController, type AnimateGradientOptions, type AnimationHooks, type AnimationSpeed, type AnsiCode, type AnsimaxConfig, 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 FontMap, type FontName, type FrameCallback, type FrameHandle, 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, type ResizeListener, 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$1 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, filterTree, findInTree, flipHorizontal, flipVertical, frames, 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, pauseListeners, presetNames, rainbow, registerFont, registerPreset, renderPixelArt, renderTree, renderTreeStream, repeatVisible, requestTerminalFrame, reset, resetColorSupportCache, resetConfig, resetCursorRefCount, resetFramesCursorCount, resetLoaderCursorCount, resetNoColor, resumeListeners, 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 { type AnimateGradientController, type AnimateGradientOptions, type AnimationHooks, type AnimationSpeed, type AnsiCode, type AnsimaxConfig, 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 FontMap, type FontName, type FrameCallback, type FrameHandle, 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, 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$1 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, filterTree, findInTree, flipHorizontal, flipVertical, frames, 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, 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 };

package/dist/index.d.ts

@@ -622,7 +622,47 @@ declare const gradient: (text: unknown, stops: string[] | null | undefined, opts
  * }
  * ```
  */
-declare const createGradient: (stops: string[] | null | undefined, defaultOpts?: Omit<GradientOptions, "phase">) => ((text: unknown, opts?: GradientOptions) => string);
+/**
+ * The function returned by `createGradient()`. Callable just like `gradient()`,
+ * but also exposes metadata for inspection and chaining.
+ */
+interface ReusableGradient {
+    /** Apply the gradient to text. */
+    (text: unknown, opts?: GradientOptions): string;
+    /** The original hex stops that were passed to `createGradient()`. */
+    readonly stops: readonly string[];
+    /** The resolved RGB stops (after filtering invalid hex). */
+    readonly resolvedStops: readonly Readonly<RGB>[];
+    /** Default options frozen at factory time. */
+    readonly defaultOptions: Readonly<Omit<GradientOptions, 'phase'>>;
+}
+declare const createGradient: (stops: string[] | null | undefined, defaultOpts?: Omit<GradientOptions, "phase">) => ReusableGradient;
+/**
+ * Return a new gradient with the stops reversed. Useful for symmetric
+ * effects (e.g. fade in / fade out) or to flip an existing palette.
+ *
+ * Accepts either:
+ * - A `ReusableGradient` returned from `createGradient()` — returns a new one
+ * - An array of hex stops — returns a new array with the order flipped
+ *
+ * @example
+ * ```ts
+ * const fire = createGradient(['#ff5555', '#ffb86c', '#f1fa8c']);
+ * const ice  = reverseGradient(fire);  // ReusableGradient with reversed stops
+ *
+ * console.log(fire('warm side'));
+ * console.log(ice('cool side'));
+ * ```
+ *
+ * @example with plain stops
+ * ```ts
+ * const stops = ['#ff0000', '#00ff00', '#0000ff'];
+ * const reversed = reverseGradient(stops);
+ * // → ['#0000ff', '#00ff00', '#ff0000']
+ * ```
+ */
+declare function reverseGradient(grad: ReusableGradient): ReusableGradient;
+declare function reverseGradient(stops: string[]): string[];
 declare const rainbow: ColorFn;
 interface AnimateGradientOptions {
     /** Total animation duration in ms. Default `2000`. */
@@ -1767,4 +1807,4 @@ declare const ansimax: {
     configure: (opts?: AnsimaxConfig, meta?: ConfigureOptions) => void;
 };
 
-export { type AnimateGradientController, type AnimateGradientOptions, type AnimationHooks, type AnimationSpeed, type AnsiCode, type AnsimaxConfig, 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 FontMap, type FontName, type FrameCallback, type FrameHandle, 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, type ResizeListener, 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$1 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, filterTree, findInTree, flipHorizontal, flipVertical, frames, 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, pauseListeners, presetNames, rainbow, registerFont, registerPreset, renderPixelArt, renderTree, renderTreeStream, repeatVisible, requestTerminalFrame, reset, resetColorSupportCache, resetConfig, resetCursorRefCount, resetFramesCursorCount, resetLoaderCursorCount, resetNoColor, resumeListeners, 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 { type AnimateGradientController, type AnimateGradientOptions, type AnimationHooks, type AnimationSpeed, type AnsiCode, type AnsimaxConfig, 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 FontMap, type FontName, type FrameCallback, type FrameHandle, 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, 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$1 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, filterTree, findInTree, flipHorizontal, flipVertical, frames, 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, 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 };

package/dist/index.js

@@ -120,6 +120,7 @@ __export(index_exports, {
   padStart: () => padStart,
   pauseListeners: () => pauseListeners,
   presetNames: () => presetNames,
+  presets: () => presets,
   rainbow: () => rainbow,
   registerFont: () => registerFont,
   registerPreset: () => registerPreset,
@@ -136,6 +137,7 @@ __export(index_exports, {
   resetLoaderCursorCount: () => resetLoaderCursorCount,
   resetNoColor: () => resetNoColor,
   resumeListeners: () => resumeListeners,
+  reverseGradient: () => reverseGradient,
   rgbTo256: () => rgbTo256,
   rgbToHex: () => rgbToHex,
   rotate90: () => rotate90,
@@ -1167,10 +1169,11 @@ var gradient = (text, stops, opts = {}) => {
   return _gradientAnsiAware(s, colors, easingFn, phaseN);
 };
 var createGradient = (stops, defaultOpts = {}) => {
-  const colors = Array.isArray(stops) ? stops.map(safeHex).filter((c) => c !== null) : [];
+  const originalStops = Array.isArray(stops) ? [...stops] : [];
+  const colors = originalStops.map(safeHex).filter((c) => c !== null);
   const defaultEasingFn = resolveEasing(defaultOpts.easing);
   const defaultPreserveAnsi = defaultOpts.preserveAnsi ?? false;
-  return (text, opts = {}) => {
+  const fn = ((text, opts = {}) => {
     const s = coerceText(text);
     if (!s || isNoColor()) return s;
     if (colors.length === 0) return s;
@@ -1186,8 +1189,31 @@ var createGradient = (stops, defaultOpts = {}) => {
       return _gradientPlain(s, colors, easingFn, phaseN);
     }
     return _gradientAnsiAware(s, colors, easingFn, phaseN);
-  };
+  });
+  Object.defineProperty(fn, "stops", {
+    value: Object.freeze(originalStops),
+    enumerable: true,
+    writable: false
+  });
+  Object.defineProperty(fn, "resolvedStops", {
+    value: Object.freeze(colors.map((c) => Object.freeze({ ...c }))),
+    enumerable: true,
+    writable: false
+  });
+  Object.defineProperty(fn, "defaultOptions", {
+    value: Object.freeze({ ...defaultOpts }),
+    enumerable: true,
+    writable: false
+  });
+  return fn;
 };
+function reverseGradient(input) {
+  if (Array.isArray(input)) {
+    return [...input].reverse();
+  }
+  const reversedStops = [...input.stops].reverse();
+  return createGradient(reversedStops, input.defaultOptions);
+}
 var _gradientPlain = (text, colors, easingFn, phase) => {
   const chars = [...text];
   const visible = chars.filter((c) => c !== " ").length;
@@ -5560,6 +5586,7 @@ var index_default = ansimax;
   padStart,
   pauseListeners,
   presetNames,
+  presets,
   rainbow,
   registerFont,
   registerPreset,
@@ -5576,6 +5603,7 @@ var index_default = ansimax;
   resetLoaderCursorCount,
   resetNoColor,
   resumeListeners,
+  reverseGradient,
   rgbTo256,
   rgbToHex,
   rotate90,

package/dist/index.mjs

@@ -993,10 +993,11 @@ var gradient = (text, stops, opts = {}) => {
   return _gradientAnsiAware(s, colors, easingFn, phaseN);
 };
 var createGradient = (stops, defaultOpts = {}) => {
-  const colors = Array.isArray(stops) ? stops.map(safeHex).filter((c) => c !== null) : [];
+  const originalStops = Array.isArray(stops) ? [...stops] : [];
+  const colors = originalStops.map(safeHex).filter((c) => c !== null);
   const defaultEasingFn = resolveEasing(defaultOpts.easing);
   const defaultPreserveAnsi = defaultOpts.preserveAnsi ?? false;
-  return (text, opts = {}) => {
+  const fn = ((text, opts = {}) => {
     const s = coerceText(text);
     if (!s || isNoColor()) return s;
     if (colors.length === 0) return s;
@@ -1012,8 +1013,31 @@ var createGradient = (stops, defaultOpts = {}) => {
       return _gradientPlain(s, colors, easingFn, phaseN);
     }
     return _gradientAnsiAware(s, colors, easingFn, phaseN);
-  };
+  });
+  Object.defineProperty(fn, "stops", {
+    value: Object.freeze(originalStops),
+    enumerable: true,
+    writable: false
+  });
+  Object.defineProperty(fn, "resolvedStops", {
+    value: Object.freeze(colors.map((c) => Object.freeze({ ...c }))),
+    enumerable: true,
+    writable: false
+  });
+  Object.defineProperty(fn, "defaultOptions", {
+    value: Object.freeze({ ...defaultOpts }),
+    enumerable: true,
+    writable: false
+  });
+  return fn;
 };
+function reverseGradient(input) {
+  if (Array.isArray(input)) {
+    return [...input].reverse();
+  }
+  const reversedStops = [...input.stops].reverse();
+  return createGradient(reversedStops, input.defaultOptions);
+}
 var _gradientPlain = (text, colors, easingFn, phase) => {
   const chars = [...text];
   const visible = chars.filter((c) => c !== " ").length;
@@ -5386,6 +5410,7 @@ export {
   padStart,
   pauseListeners,
   presetNames,
+  presets,
   rainbow,
   registerFont,
   registerPreset,
@@ -5402,6 +5427,7 @@ export {
   resetLoaderCursorCount,
   resetNoColor,
   resumeListeners,
+  reverseGradient,
   rgbTo256,
   rgbToHex,
   rotate90,

package/examples/all-in-one.cjs

@@ -118,7 +118,7 @@ async function main() {
   console.log(components.section('🏷️  Badges & Status', { width: 60 }));
   console.log();
   console.log(' ',
-    components.badge('VERSION', 'v1.2.3'),
+    components.badge('VERSION', 'v1.2.4'),
     components.badge('BUILD', 'passing'),
     components.badge('LICENSE', 'Apache 2.0'));
   console.log();

package/examples/all-in-one.mjs

@@ -117,7 +117,7 @@ console.log();
 console.log(components.section('🏷️  Badges & Status', { width: 60 }));
 console.log();
 console.log(' ',
-  components.badge('VERSION', 'v1.2.3'),
+  components.badge('VERSION', 'v1.2.4'),
   components.badge('BUILD', 'passing'),
   components.badge('LICENSE', 'Apache 2.0'));
 console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ansimax",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "description": "Zero-dependency CLI rendering library: colors, gradients, animations, ASCII art, pixel art, components, and themes \u2014 all in TypeScript.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",