ansimax 1.3.3 → 1.3.5

package/dist/index.js

@@ -60,8 +60,10 @@ __export(index_exports, {
   chain: () => chain,
   charWidth: () => charWidth,
   clamp: () => clamp,
+  clampByte: () => clampByte2,
   clearAnsiCache: () => clearAnsiCache,
   clearColorCache: () => clearColorCache,
+  clearLine: () => clearLine,
   clearRenderCache: () => clearRenderCache,
   clearThemeColorCache: () => clearThemeColorCache,
   color: () => color,
@@ -79,6 +81,8 @@ __export(index_exports, {
   debounce: () => debounce,
   default: () => index_default,
   diffLines: () => diffLines,
+  easings: () => easings,
+  escapeForRegex: () => escapeForRegex,
   escapeRegex: () => escapeRegex,
   fg256: () => fg256,
   fgRgb: () => fgRgb,
@@ -99,13 +103,17 @@ __export(index_exports, {
   gradient: () => gradient,
   gradientColor: () => gradientColor,
   gradientRect: () => gradientRect,
+  gradientStops: () => gradientStops,
   graphemes: () => graphemes,
   grid: () => grid,
   hasFont: () => hasFont,
   hexToRgb: () => hexToRgb,
   hideCursor: () => hideCursor,
+  hslToRgb: () => hslToRgb,
   hsplit: () => hsplit,
+  hyperlink: () => hyperlink,
   images: () => images,
+  isFiniteNumber: () => isFiniteNumber2,
   isHexColor: () => isHexColor,
   isNoColor: () => isNoColor,
   json: () => json,
@@ -117,9 +125,12 @@ __export(index_exports, {
   listPresets: () => listPresets,
   loader: () => loader,
   mapTree: () => mapTree,
+  measureBlock: () => measureBlock,
   measureTree: () => measureTree,
   memoize: () => memoize,
+  mixColors: () => mixColors,
   nextTick: () => nextTick,
+  oklabToRgb: () => oklabToRgb,
   onConfigChange: () => onConfigChange,
   onConfigKeyChange: () => onConfigKeyChange,
   onResize: () => onResize,
@@ -132,6 +143,7 @@ __export(index_exports, {
   pauseListeners: () => pauseListeners,
   presetNames: () => presetNames,
   presets: () => presets,
+  quantizeColor: () => quantizeColor,
   rainbow: () => rainbow,
   registerFont: () => registerFont,
   registerPreset: () => registerPreset,
@@ -147,13 +159,18 @@ __export(index_exports, {
   resetFramesCursorCount: () => resetFramesCursorCount,
   resetLoaderCursorCount: () => resetLoaderCursorCount,
   resetNoColor: () => resetNoColor,
+  resolveEasingByName: () => resolveEasingByName,
   resumeListeners: () => resumeListeners,
   reverseGradient: () => reverseGradient,
   rgbTo256: () => rgbTo256,
   rgbToHex: () => rgbToHex,
+  rgbToHsl: () => rgbToHsl,
+  rgbToOklab: () => rgbToOklab,
   rotate90: () => rotate90,
+  safeInt: () => safeInt,
   safeJson: () => safeJson,
   screen: () => screen,
+  setConfigValue: () => setConfigValue,
   setNoColor: () => setNoColor,
   setTitle: () => setTitle,
   sgr: () => sgr,
@@ -164,6 +181,7 @@ __export(index_exports, {
   stripAnsi: () => stripAnsi2,
   stripAnsiCodes: () => stripAnsi,
   stripAnsiColors: () => stripAnsi3,
+  subscribeConfig: () => subscribeConfig,
   supportsColor: () => supportsColor,
   supportsColorLevel: () => supportsColorLevel,
   termSize: () => termSize,
@@ -567,8 +585,26 @@ var sleepFrame = (ms = FRAME_MS, opts = {}) => sleep(
   Math.max(FRAME_MS, Math.round((isFiniteNumber(ms) ? ms : FRAME_MS) / FRAME_MS) * FRAME_MS),
   opts
 );
+var hyperlink = (url, label) => {
+  if (typeof url !== "string" || url.length === 0) {
+    return typeof label === "string" ? label : "";
+  }
+  const safeLabel = typeof label === "string" && label.length > 0 ? label : url;
+  return `${OSC}8;;${url}${ST}${safeLabel}${OSC}8;;${ST}`;
+};
+var clearLine = () => `${CSI}2K\r`;
 
 // src/utils/helpers.ts
+var isFiniteNumber2 = (n) => typeof n === "number" && Number.isFinite(n);
+var safeInt = (value, fallback = 0, min = -Infinity, max = Infinity) => {
+  const isRealNumeric = typeof value === "number" || typeof value === "string" && value.trim().length > 0 && Number.isFinite(Number(value));
+  if (!isRealNumeric) {
+    return Math.max(min, Math.min(max, Math.floor(fallback)));
+  }
+  const n = Number(value);
+  if (!Number.isFinite(n)) return Math.max(min, Math.min(max, Math.floor(fallback)));
+  return Math.max(min, Math.min(max, Math.floor(n)));
+};
 var clamp = (n, min, max) => Math.min(Math.max(n, min), max);
 var lerp = (a, b, t) => a + (b - a) * t;
 var clampByte2 = (v) => clamp(Math.round(v), 0, 255);
@@ -584,25 +620,148 @@ var hexToRgb = (hex) => {
   return { r: int >> 16 & 255, g: int >> 8 & 255, b: int & 255 };
 };
 var rgbToHex = (r, g, b) => "#" + [clampByte2(r), clampByte2(g), clampByte2(b)].map((v) => v.toString(16).padStart(2, "0")).join("");
-var lerpColor = (a, b, t) => {
+var rgbToHsl = (rgb) => {
+  const r = clamp(rgb.r, 0, 255) / 255;
+  const g = clamp(rgb.g, 0, 255) / 255;
+  const b = clamp(rgb.b, 0, 255) / 255;
+  const max = Math.max(r, g, b);
+  const min = Math.min(r, g, b);
+  const l = (max + min) / 2;
+  if (max === min) {
+    return { h: 0, s: 0, l };
+  }
+  const d = max - min;
+  const s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+  let h;
+  if (max === r) {
+    h = ((g - b) / d + (g < b ? 6 : 0)) * 60;
+  } else if (max === g) {
+    h = ((b - r) / d + 2) * 60;
+  } else {
+    h = ((r - g) / d + 4) * 60;
+  }
+  return { h, s, l };
+};
+var hslToRgb = (hsl) => {
+  const h = (hsl.h % 360 + 360) % 360 / 360;
+  const s = clamp(hsl.s, 0, 1);
+  const l = clamp(hsl.l, 0, 1);
+  if (s === 0) {
+    const v = Math.round(l * 255);
+    return { r: v, g: v, b: v };
+  }
+  const hue2rgb = (p2, q2, t) => {
+    let tt = t;
+    if (tt < 0) tt += 1;
+    if (tt > 1) tt -= 1;
+    if (tt < 1 / 6) return p2 + (q2 - p2) * 6 * tt;
+    if (tt < 1 / 2) return q2;
+    if (tt < 2 / 3) return p2 + (q2 - p2) * (2 / 3 - tt) * 6;
+    return p2;
+  };
+  const q = l < 0.5 ? l * (1 + s) : l + s - l * s;
+  const p = 2 * l - q;
+  return {
+    r: Math.round(hue2rgb(p, q, h + 1 / 3) * 255),
+    g: Math.round(hue2rgb(p, q, h) * 255),
+    b: Math.round(hue2rgb(p, q, h - 1 / 3) * 255)
+  };
+};
+var _srgbToLinear = (c) => {
+  const x = c / 255;
+  return x <= 0.04045 ? x / 12.92 : Math.pow((x + 0.055) / 1.055, 2.4);
+};
+var _linearToSrgb = (c) => {
+  const x = c <= 31308e-7 ? 12.92 * c : 1.055 * Math.pow(c, 1 / 2.4) - 0.055;
+  return clampByte2(x * 255);
+};
+var rgbToOklab = (rgb) => {
+  const r = _srgbToLinear(rgb.r);
+  const g = _srgbToLinear(rgb.g);
+  const b = _srgbToLinear(rgb.b);
+  const l = 0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b;
+  const m = 0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b;
+  const s = 0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b;
+  const l_ = Math.cbrt(l);
+  const m_ = Math.cbrt(m);
+  const s_ = Math.cbrt(s);
+  return {
+    L: 0.2104542553 * l_ + 0.793617785 * m_ - 0.0040720468 * s_,
+    a: 1.9779984951 * l_ - 2.428592205 * m_ + 0.4505937099 * s_,
+    b: 0.0259040371 * l_ + 0.7827717662 * m_ - 0.808675766 * s_
+  };
+};
+var oklabToRgb = (oklab) => {
+  const l_ = oklab.L + 0.3963377774 * oklab.a + 0.2158037573 * oklab.b;
+  const m_ = oklab.L - 0.1055613458 * oklab.a - 0.0638541728 * oklab.b;
+  const s_ = oklab.L - 0.0894841775 * oklab.a - 1.291485548 * oklab.b;
+  const l = l_ * l_ * l_;
+  const m = m_ * m_ * m_;
+  const s = s_ * s_ * s_;
+  const r = 4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s;
+  const g = -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s;
+  const b = -0.0041960863 * l - 0.7034186147 * m + 1.707614701 * s;
+  return {
+    r: _linearToSrgb(r),
+    g: _linearToSrgb(g),
+    b: _linearToSrgb(b)
+  };
+};
+var lerpColor = (a, b, t, space = "rgb") => {
   const ct = clamp(t, 0, 1);
+  if (space === "oklab") {
+    const la = rgbToOklab(a);
+    const lb = rgbToOklab(b);
+    return oklabToRgb({
+      L: lerp(la.L, lb.L, ct),
+      a: lerp(la.a, lb.a, ct),
+      b: lerp(la.b, lb.b, ct)
+    });
+  }
+  if (space === "hsl") {
+    const ha = rgbToHsl(a);
+    const hb = rgbToHsl(b);
+    let dh = hb.h - ha.h;
+    if (dh > 180) dh -= 360;
+    else if (dh < -180) dh += 360;
+    const h = ha.h + dh * ct;
+    return hslToRgb({
+      h,
+      s: lerp(ha.s, hb.s, ct),
+      l: lerp(ha.l, hb.l, ct)
+    });
+  }
   return {
     r: Math.round(lerp(a.r, b.r, ct)),
     g: Math.round(lerp(a.g, b.g, ct)),
     b: Math.round(lerp(a.b, b.b, ct))
   };
 };
-var gradientColor = (colors, t) => {
+var mixColors = (a, b, t, space = "rgb") => {
+  const ra = typeof a === "string" ? hexToRgb(a) : a;
+  const rb = typeof b === "string" ? hexToRgb(b) : b;
+  return lerpColor(ra, rb, t, space);
+};
+var quantizeColor = (color2, levels = 4) => {
+  const safeLevels = Math.max(2, Math.floor(levels));
+  const step = 255 / (safeLevels - 1);
+  return {
+    r: Math.round(clampByte2(color2.r) / step) * step | 0,
+    g: Math.round(clampByte2(color2.g) / step) * step | 0,
+    b: Math.round(clampByte2(color2.b) / step) * step | 0
+  };
+};
+var gradientColor = (colors, t, space = "rgb") => {
   if (!Array.isArray(colors) || colors.length === 0) {
     throw new Error("gradientColor requires at least one color stop");
   }
   if (colors.length === 1) return colors[0];
-  const safeT = typeof t === "number" && Number.isFinite(t) ? t : 0;
+  const safeT = isFiniteNumber2(t) ? t : 0;
   const ct = clamp(safeT, 0, 1);
   const scaled = ct * (colors.length - 1);
   const lo = Math.floor(scaled);
   const hi = Math.min(lo + 1, colors.length - 1);
-  return lerpColor(colors[lo], colors[hi], scaled - lo);
+  return lerpColor(colors[lo], colors[hi], scaled - lo, space);
 };
 var rgbTo256 = (r, g, b) => {
   const cr = clampByte2(r), cg = clampByte2(g), cb = clampByte2(b);
@@ -989,6 +1148,35 @@ var padBoth = (str, width, ch = " ") => {
   const r = pad - l;
   return ch.repeat(l) + str + ch.repeat(r);
 };
+var gradientStops = (start, end, count, space = "rgb") => {
+  const safeCount = Math.max(2, Math.floor(Number.isFinite(count) ? count : 2));
+  if (!isHexColor(start) || !isHexColor(end)) return [];
+  const a = hexToRgb(start);
+  const b = hexToRgb(end);
+  const result = [];
+  for (let i = 0; i < safeCount; i++) {
+    const t = i / (safeCount - 1);
+    const c = lerpColor(a, b, t, space);
+    result.push(rgbToHex(c.r, c.g, c.b));
+  }
+  return result;
+};
+var escapeForRegex = (str) => {
+  if (typeof str !== "string") return "";
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+};
+var measureBlock = (block) => {
+  if (typeof block !== "string" || block.length === 0) {
+    return { width: 0, height: 0 };
+  }
+  const lines = block.split("\n");
+  let width = 0;
+  for (const line of lines) {
+    const w = visibleLen(line);
+    if (w > width) width = w;
+  }
+  return { width, height: lines.length };
+};
 
 // src/colors/index.ts
 var _noColor = null;
@@ -1852,8 +2040,8 @@ var pulse = async (text, opts = {}) => {
     fireDone(hooks, isAborted(signal));
     return;
   }
-  const c1 = resolveRgb(color1);
-  const c2 = resolveRgb(color2);
+  const c12 = resolveRgb(color1);
+  const c22 = resolveRgb(color2);
   const cycles = Math.max(1, Math.round(times));
   const halfInterval = Math.max(FRAME_MS, interval);
   registerCrashHandlers();
@@ -1867,7 +2055,7 @@ var pulse = async (text, opts = {}) => {
         break;
       }
       await safeWriteAsync(
-        cursor.save() + fgRgb(c1.r, c1.g, c1.b) + text + reset() + cursor.restore()
+        cursor.save() + fgRgb(c12.r, c12.g, c12.b) + text + reset() + cursor.restore()
       );
       fireFrame(hooks, frame2++);
       await sleep(halfInterval, { signal });
@@ -1876,14 +2064,14 @@ var pulse = async (text, opts = {}) => {
         break;
       }
       await safeWriteAsync(
-        cursor.save() + fgRgb(c2.r, c2.g, c2.b) + text + reset() + cursor.restore()
+        cursor.save() + fgRgb(c22.r, c22.g, c22.b) + text + reset() + cursor.restore()
       );
       fireFrame(hooks, frame2++);
       await sleep(halfInterval, { signal });
     }
     if (!aborted) {
       await safeWriteAsync(
-        cursor.save() + fgRgb(c1.r, c1.g, c1.b) + text + reset() + cursor.restore()
+        cursor.save() + fgRgb(c12.r, c12.g, c12.b) + text + reset() + cursor.restore()
       );
     }
   } finally {
@@ -2112,6 +2300,131 @@ var delay = (ms) => async (opts = {}) => {
   } catch {
   }
 };
+var shake = async (text, opts = {}) => {
+  const {
+    times = 5,
+    intensity = 2,
+    interval = 50,
+    newline = true,
+    signal,
+    reducedMotion = false,
+    onFrame,
+    onDone,
+    onAbort
+  } = opts;
+  const hooks = { onFrame, onDone, onAbort };
+  if (reducedMotion || isAborted(signal)) {
+    safeWrite(text);
+    if (newline) writeln();
+    fireDone(hooks, isAborted(signal));
+    return;
+  }
+  const safeText = typeof text === "string" ? text : "";
+  const safeTimes = Math.max(1, Math.round(times));
+  const safeIntensity = Math.max(1, Math.round(intensity));
+  const safeInterval = Math.max(FRAME_MS, interval);
+  const pattern = [0, safeIntensity, 0, -safeIntensity];
+  registerCrashHandlers();
+  hideCursorSafe();
+  let aborted = false;
+  let frame2 = 0;
+  try {
+    for (let cycle = 0; cycle < safeTimes; cycle++) {
+      for (const offset of pattern) {
+        if (isAborted(signal)) {
+          aborted = true;
+          break;
+        }
+        const prefix = offset > 0 ? " ".repeat(offset) : "";
+        await safeWriteAsync(
+          cursor.save() + screen.clearLine() + "\r" + prefix + safeText + cursor.restore()
+        );
+        fireFrame(hooks, frame2++);
+        await sleep(safeInterval, { signal });
+      }
+      if (aborted) break;
+    }
+    if (!aborted) {
+      await safeWriteAsync(cursor.save() + screen.clearLine() + "\r" + safeText + cursor.restore());
+    }
+  } finally {
+    showCursorSafe();
+    if (newline) writeln();
+    fireDone(hooks, aborted);
+  }
+};
+var countUp = async (from, to, opts = {}) => {
+  const {
+    duration = 1500,
+    steps = 60,
+    decimals = 0,
+    format = (n) => n.toString(),
+    easing = (t) => t,
+    newline = true,
+    signal,
+    reducedMotion = false,
+    onFrame,
+    onDone,
+    onAbort
+  } = opts;
+  const hooks = { onFrame, onDone, onAbort };
+  const safeFrom = Number.isFinite(from) ? from : 0;
+  const safeTo = Number.isFinite(to) ? to : 0;
+  const safeDecimals = Math.max(0, Math.min(20, Math.floor(decimals)));
+  const safeFormat = typeof format === "function" ? format : (n) => n.toString();
+  const safeEasing = typeof easing === "function" ? easing : (t) => t;
+  if (reducedMotion || isAborted(signal)) {
+    safeWrite(safeFormat(parseFloat(safeTo.toFixed(safeDecimals))));
+    if (newline) writeln();
+    fireDone(hooks, isAborted(signal));
+    return;
+  }
+  const safeSteps2 = Math.max(1, Math.round(steps));
+  const interval = Math.max(FRAME_MS, Math.round(duration / safeSteps2));
+  registerCrashHandlers();
+  hideCursorSafe();
+  let aborted = false;
+  let frame2 = 0;
+  try {
+    for (let i = 0; i <= safeSteps2; i++) {
+      if (isAborted(signal)) {
+        aborted = true;
+        break;
+      }
+      const t = i / safeSteps2;
+      const eased = safeEasing(Math.max(0, Math.min(1, t)));
+      const current = safeFrom + (safeTo - safeFrom) * eased;
+      const rounded = parseFloat(current.toFixed(safeDecimals));
+      let display;
+      try {
+        display = safeFormat(rounded);
+      } catch {
+        display = String(rounded);
+      }
+      await safeWriteAsync(
+        cursor.save() + screen.clearLine() + "\r" + display + cursor.restore()
+      );
+      fireFrame(hooks, frame2++);
+      if (i < safeSteps2) await sleep(interval, { signal });
+    }
+    if (!aborted) {
+      const final = parseFloat(safeTo.toFixed(safeDecimals));
+      let display;
+      try {
+        display = safeFormat(final);
+      } catch {
+        display = String(final);
+      }
+      await safeWriteAsync(
+        cursor.save() + screen.clearLine() + "\r" + display + cursor.restore()
+      );
+    }
+  } finally {
+    showCursorSafe();
+    if (newline) writeln();
+    fireDone(hooks, aborted);
+  }
+};
 var animate = {
   typewriter,
   fadeIn,
@@ -2124,7 +2437,10 @@ var animate = {
   sequence,
   chain: chain2,
   parallel,
-  delay
+  delay,
+  // v1.3.4
+  shake,
+  countUp
 };
 
 // src/ascii/index.ts
@@ -2926,14 +3242,14 @@ var ascii = {
 
 // src/loaders/index.ts
 var canAnimate2 = () => Boolean(process.stdout?.isTTY) && supportsColor() !== "none";
-var isFiniteNumber2 = (n) => typeof n === "number" && Number.isFinite(n);
+var isFiniteNumber3 = (n) => typeof n === "number" && Number.isFinite(n);
 var ensureString3 = (v) => typeof v === "string" ? v : String(v ?? "");
 var clampPositiveInt = (n, fallback) => {
-  if (!isFiniteNumber2(n)) return fallback;
+  if (!isFiniteNumber3(n)) return fallback;
   return Math.max(1, Math.floor(n));
 };
 var clampPercent = (p) => {
-  if (!isFiniteNumber2(p)) return 0;
+  if (!isFiniteNumber3(p)) return 0;
   return Math.max(0, Math.min(100, p));
 };
 var isUnicodeCapable = () => {
@@ -3325,7 +3641,7 @@ var custom = (frames2, text = "", opts = {}) => {
 };
 var countdown = async (seconds, opts = {}) => {
   const { label = "Starting in", color: hex, signal } = opts;
-  const safeSeconds = isFiniteNumber2(seconds) ? Math.max(0, Math.floor(seconds)) : 0;
+  const safeSeconds = isFiniteNumber3(seconds) ? Math.max(0, Math.floor(seconds)) : 0;
   const safeLabel = ensureString3(label);
   const colorToUse = safeColor(hex) ? hex : "#ffd700";
   if (!canAnimate2() || signal?.aborted) {
@@ -3532,11 +3848,11 @@ var loader = {
 };
 
 // src/frames/index.ts
-var isFiniteNumber3 = (n) => typeof n === "number" && Number.isFinite(n);
+var isFiniteNumber4 = (n) => typeof n === "number" && Number.isFinite(n);
 var ensureString4 = (v) => typeof v === "string" ? v : String(v ?? "");
 var MAX_FPS = 60;
 var clampFps = (fps, fallback) => {
-  if (!isFiniteNumber3(fps)) return fallback;
+  if (!isFiniteNumber4(fps)) return fallback;
   return Math.max(1, Math.min(MAX_FPS, Math.floor(fps)));
 };
 var _cursorHiddenCount2 = 0;
@@ -3635,14 +3951,14 @@ var play = (frames2, opts = {}) => {
   if (fps !== void 0) {
     const safeFps = clampFps(fps, 60);
     tickMs = Math.max(FRAME_MS, Math.floor(1e3 / safeFps));
-  } else if (isFiniteNumber3(interval)) {
+  } else if (isFiniteNumber4(interval)) {
     tickMs = Math.max(FRAME_MS, Math.floor(interval));
   } else {
     tickMs = 100;
   }
   let safeRepeat;
   let infinite;
-  if (!isFiniteNumber3(repeat)) {
+  if (!isFiniteNumber4(repeat)) {
     safeRepeat = 1;
     infinite = false;
   } else if (repeat === 0) {
@@ -3767,7 +4083,7 @@ var play = (frames2, opts = {}) => {
       paused = false;
     },
     seek: (idx) => {
-      if (!isFiniteNumber3(idx)) return;
+      if (!isFiniteNumber4(idx)) return;
       const safe = Math.max(0, Math.floor(idx));
       frameIdx = frames2.length > 0 ? safe % frames2.length : 0;
     },
@@ -3780,7 +4096,7 @@ var play = (frames2, opts = {}) => {
   };
 };
 var generate = (count, fn) => {
-  const safeCount = isFiniteNumber3(count) ? Math.max(0, Math.floor(count)) : 0;
+  const safeCount = isFiniteNumber4(count) ? Math.max(0, Math.floor(count)) : 0;
   if (typeof fn !== "function") return Array(safeCount).fill("");
   return Array.from({ length: safeCount }, (_, i) => {
     try {
@@ -3852,7 +4168,7 @@ var morph = (frameA, frameB, steps = 8, charset = "\u2591\u2592\u2593\u2588\u259
   const a0 = ensureString4(frameA);
   const b0 = ensureString4(frameB);
   if (!a0 && !b0) return [""];
-  const n = Math.max(2, isFiniteNumber3(steps) ? Math.floor(steps) : 8);
+  const n = Math.max(2, isFiniteNumber4(steps) ? Math.floor(steps) : 8);
   const len = Math.max(a0.length, b0.length);
   const a = a0.padEnd(len);
   const b = b0.padEnd(len);
@@ -3874,7 +4190,7 @@ var morph = (frameA, frameB, steps = 8, charset = "\u2591\u2592\u2593\u2588\u259
 var presets2 = {
   loadingBar: (opts = {}) => {
     const { width = 20, char = "\u2588", empty = "\u2591", label = "Loading" } = opts;
-    const safeWidth = Math.max(0, isFiniteNumber3(width) ? Math.floor(width) : 20);
+    const safeWidth = Math.max(0, isFiniteNumber4(width) ? Math.floor(width) : 20);
     const safeChar = typeof char === "string" && char.length > 0 ? char : "\u2588";
     const safeEmpty = typeof empty === "string" && empty.length > 0 ? empty : "\u2591";
     const safeLabel = ensureString4(label);
@@ -3888,7 +4204,7 @@ var presets2 = {
   /* istanbul ignore next — default opts {} */
   ball: (opts = {}) => {
     const { width = 20, char = "\u25CF" } = opts;
-    const safeWidth = Math.max(1, isFiniteNumber3(width) ? Math.floor(width) : 20);
+    const safeWidth = Math.max(1, isFiniteNumber4(width) ? Math.floor(width) : 20);
     const safeChar = typeof char === "string" && char.length > 0 ? char : "\u25CF";
     const forward = generate(safeWidth, (i) => " ".repeat(i) + safeChar);
     const backward = generate(safeWidth, (i) => " ".repeat(safeWidth - i - 1) + safeChar);
@@ -3898,7 +4214,7 @@ var presets2 = {
   breathe: (text, opts = {}) => {
     const { steps = 8 } = opts;
     const safeText = ensureString4(text);
-    const safeSteps2 = Math.max(1, isFiniteNumber3(steps) ? Math.floor(steps) : 8);
+    const safeSteps2 = Math.max(1, isFiniteNumber4(steps) ? Math.floor(steps) : 8);
     const shades = ["\u2591", "\u2592", "\u2593", "\u2588"];
     return generate(safeSteps2 * 2, (i) => {
       const t = i < safeSteps2 ? i / safeSteps2 : 1 - (i - safeSteps2) / safeSteps2;
@@ -3919,22 +4235,22 @@ var presets2 = {
 var frames = { play, generate, live, morph, presets: presets2 };
 
 // src/components/index.ts
-var isFiniteNumber4 = (n) => typeof n === "number" && Number.isFinite(n);
+var isFiniteNumber5 = (n) => typeof n === "number" && Number.isFinite(n);
 var ensureString5 = (v) => typeof v === "string" ? v : String(v ?? "");
 var clampPercent2 = (p) => {
-  if (!isFiniteNumber4(p)) return 0;
+  if (!isFiniteNumber5(p)) return 0;
   return Math.max(0, Math.min(100, p));
 };
 var clampNonNeg = (n, fallback) => {
-  if (!isFiniteNumber4(n)) return fallback;
+  if (!isFiniteNumber5(n)) return fallback;
   return Math.max(0, Math.floor(n));
 };
 var clampPositive2 = (n, fallback) => {
-  if (!isFiniteNumber4(n)) return fallback;
+  if (!isFiniteNumber5(n)) return fallback;
   return Math.max(1, Math.floor(n));
 };
 var safeSgrCode = (code, fallback) => {
-  if (!isFiniteNumber4(code)) return fallback;
+  if (!isFiniteNumber5(code)) return fallback;
   return Math.max(0, Math.min(255, Math.floor(code)));
 };
 var truncateVisible = (str, maxWidth, ellipsis = "\u2026") => {
@@ -3972,7 +4288,7 @@ var table = (rows, opts = {}) => {
   const b = TABLE_BORDERS[borderStyle] ?? TABLE_BORDERS.rounded;
   const safePadding = clampNonNeg(padding, 1);
   const pad = " ".repeat(safePadding);
-  const safeMaxCol = maxColWidth !== null && isFiniteNumber4(maxColWidth) ? Math.max(1, Math.floor(maxColWidth)) : null;
+  const safeMaxCol = maxColWidth !== null && isFiniteNumber5(maxColWidth) ? Math.max(1, Math.floor(maxColWidth)) : null;
   const validRows = rows.filter((r) => Array.isArray(r));
   if (validRows.length === 0) return "";
   const cols = Math.max(...validRows.map((r) => r.length), 0);
@@ -4053,7 +4369,7 @@ var progressBar = (percent, opts = {}) => {
     showPercentage = true,
     label = "",
     color: color2 = null,
-    gradient: gradientStops = null
+    gradient: gradientStops2 = null
   } = opts;
   const safeWidth = clampPositive2(width, 30);
   const safeChar = typeof char === "string" && char.length > 0 ? char : "\u2588";
@@ -4063,9 +4379,9 @@ var progressBar = (percent, opts = {}) => {
   const filled = Math.floor(clamped / 100 * safeWidth);
   const empty = Math.max(0, safeWidth - filled);
   let filledStr = safeChar.repeat(filled);
-  if (Array.isArray(gradientStops) && gradientStops.length >= 1 && filled > 0) {
-    filledStr = gradient(filledStr, gradientStops);
-  } else if (color2 !== null && isFiniteNumber4(color2)) {
+  if (Array.isArray(gradientStops2) && gradientStops2.length >= 1 && filled > 0) {
+    filledStr = gradient(filledStr, gradientStops2);
+  } else if (color2 !== null && isFiniteNumber5(color2)) {
     filledStr = sgr(safeSgrCode(color2, FG.white)) + filledStr + reset();
   }
   const emptyStr = safeEmpty.repeat(empty);
@@ -4101,7 +4417,7 @@ var section = (title, opts = {}) => {
   const safeChar = typeof char === "string" && char.length > 0 ? char : "\u2500";
   const safeColor2 = safeSgrCode(colorCode, FG.cyan);
   const titleLen = visibleLen(safeTitle);
-  const requestedWidth = width !== null && isFiniteNumber4(width) ? Math.max(1, Math.floor(width)) : cols;
+  const requestedWidth = width !== null && isFiniteNumber5(width) ? Math.max(1, Math.floor(width)) : cols;
   const w = Math.max(requestedWidth, titleLen + 2);
   const side = Math.floor((w - titleLen - 2) / 2);
   const dividerL = sgr(safeColor2) + safeChar.repeat(Math.max(0, side)) + reset();
@@ -4115,7 +4431,7 @@ var columns = (items, opts = {}) => {
   const safeCols = clampPositive2(numCols, 2);
   const safeGap = clampNonNeg(gap, 2);
   const { cols: termCols } = termSize();
-  const totalW = width !== null && isFiniteNumber4(width) ? Math.max(safeCols, Math.floor(width)) : termCols;
+  const totalW = width !== null && isFiniteNumber5(width) ? Math.max(safeCols, Math.floor(width)) : termCols;
   const colW = Math.max(1, Math.floor((totalW - safeGap * (safeCols - 1)) / safeCols));
   const gapStr = " ".repeat(safeGap);
   const rows = [];
@@ -4155,7 +4471,7 @@ var timeline = (events, opts = {}) => {
   const safeColor2 = safeSgrCode(colorCode, FG.cyan);
   const safeDoneColor = safeSgrCode(doneColor, FG.green);
   const safePendingColor = safeSgrCode(pendingColor, FG.brightBlack);
-  const computedTimeWidth = timeColumnWidth !== null && isFiniteNumber4(timeColumnWidth) ? Math.max(0, Math.floor(timeColumnWidth)) : Math.max(0, ...events.map((e) => e.time ? visibleLen(ensureString5(e.time)) : 0));
+  const computedTimeWidth = timeColumnWidth !== null && isFiniteNumber5(timeColumnWidth) ? Math.max(0, Math.floor(timeColumnWidth)) : Math.max(0, ...events.map((e) => e.time ? visibleLen(ensureString5(e.time)) : 0));
   const lines = [];
   events.forEach((ev, i) => {
     const isLast = i === events.length - 1;
@@ -4347,10 +4663,10 @@ var STYLES = {
   heavy: { branch: "\u2523\u2501\u2501 ", last: "\u2517\u2501\u2501 ", vert: "\u2503   ", space: "    " },
   ascii: { branch: "+-- ", last: "`-- ", vert: "|   ", space: "    " }
 };
-var isFiniteNumber5 = (n) => typeof n === "number" && Number.isFinite(n);
+var isFiniteNumber6 = (n) => typeof n === "number" && Number.isFinite(n);
 var ensureString6 = (v) => typeof v === "string" ? v : String(v ?? "");
 var clampNonNeg2 = (n, fallback) => {
-  if (!isFiniteNumber5(n)) return fallback;
+  if (!isFiniteNumber6(n)) return fallback;
   return Math.max(0, Math.floor(n));
 };
 var normalizeNewlines = (s) => s.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
@@ -4422,7 +4738,7 @@ var renderChildren = (children, parentContinuation, lines, indentStr, defaultSty
   if (!Array.isArray(children)) return;
   let visible = children;
   let collapsedCount = 0;
-  const safeCollapse = isFiniteNumber5(collapse) ? Math.floor(collapse) : 0;
+  const safeCollapse = isFiniteNumber6(collapse) ? Math.floor(collapse) : 0;
   if (safeCollapse > 0 && safeCollapse < children.length) {
     visible = children.slice(safeCollapse);
     collapsedCount = safeCollapse;
@@ -4492,7 +4808,7 @@ var renderTree = (root, opts = {}) => {
   } = opts;
   const safeStyle = style && STYLES[style] ? style : "normal";
   const safeIndent = clampNonNeg2(indent, 0);
-  const safeMaxDepth = isFiniteNumber5(maxDepth) ? Math.max(0, Math.floor(maxDepth)) : Infinity;
+  const safeMaxDepth = isFiniteNumber6(maxDepth) ? Math.max(0, Math.floor(maxDepth)) : Infinity;
   const indentStr = " ".repeat(safeIndent);
   const lines = [];
   const rootLabel = formatNode(root, 0, palette);
@@ -5111,13 +5427,13 @@ var themes = {
 var FULL_BLOCK = "\u2588";
 var UPPER_HALF = "\u2580";
 var LOWER_HALF = "\u2584";
-var isFiniteNumber6 = (n) => typeof n === "number" && Number.isFinite(n);
+var isFiniteNumber7 = (n) => typeof n === "number" && Number.isFinite(n);
 var clampInt = (n, min, max, fallback) => {
-  if (!isFiniteNumber6(n)) return fallback;
+  if (!isFiniteNumber7(n)) return fallback;
   return Math.max(min, Math.min(max, Math.floor(n)));
 };
 var clampByte3 = (n) => {
-  if (!isFiniteNumber6(n)) return 0;
+  if (!isFiniteNumber7(n)) return 0;
   return Math.max(0, Math.min(255, Math.round(n)));
 };
 var MAX_DIMENSION = 1e4;
@@ -5422,7 +5738,7 @@ var gradientRect = (opts = {}) => {
   const safeW = clampInt(width, 2, MAX_DIMENSION, 40);
   const safeH = clampInt(height, 2, MAX_DIMENSION, 10);
   let cosA = 1, sinA = 0;
-  if (isFiniteNumber6(angle)) {
+  if (isFiniteNumber7(angle)) {
     const rad = angle * Math.PI / 180;
     cosA = Math.cos(rad);
     sinA = Math.sin(rad);
@@ -5432,7 +5748,7 @@ var gradientRect = (opts = {}) => {
     const line = [];
     for (let col = 0; col < safeW; col++) {
       let t;
-      if (isFiniteNumber6(angle)) {
+      if (isFiniteNumber7(angle)) {
         const projection = col / (safeW - 1) * cosA + row / (safeH - 1) * sinA;
         t = clamp((projection + 1) / 2, 0, 1);
       } else if (style === "horizontal") t = col / (safeW - 1);
@@ -5489,7 +5805,7 @@ var createCanvas = (width, height, fillColor = null) => {
     if (y > dirtyMaxY) dirtyMaxY = y;
   };
   const setInternal = (x, y, color2) => {
-    if (!isFiniteNumber6(x) || !isFiniteNumber6(y)) return;
+    if (!isFiniteNumber7(x) || !isFiniteNumber7(y)) return;
     const ix = Math.floor(x);
     const iy = Math.floor(y);
     if (iy < 0 || iy >= h || ix < 0 || ix >= w) return;
@@ -5504,7 +5820,7 @@ var createCanvas = (width, height, fillColor = null) => {
     },
     set: setInternal,
     get(x, y) {
-      if (!isFiniteNumber6(x) || !isFiniteNumber6(y)) return null;
+      if (!isFiniteNumber7(x) || !isFiniteNumber7(y)) return null;
       const ix = Math.floor(x), iy = Math.floor(y);
       return cloneColor(pixels[iy]?.[ix] ?? null);
     },
@@ -5520,7 +5836,7 @@ var createCanvas = (width, height, fillColor = null) => {
       dirtyMaxY = h - 1;
     },
     drawRect(x, y, rw, rh, color2, fill = false) {
-      if (!isFiniteNumber6(x) || !isFiniteNumber6(y) || !isFiniteNumber6(rw) || !isFiniteNumber6(rh)) return;
+      if (!isFiniteNumber7(x) || !isFiniteNumber7(y) || !isFiniteNumber7(rw) || !isFiniteNumber7(rh)) return;
       if (rw <= 0 || rh <= 0) return;
       const ix = Math.floor(x);
       const iy = Math.floor(y);
@@ -5542,7 +5858,7 @@ var createCanvas = (width, height, fillColor = null) => {
       }
     },
     drawCircle(cx, cy, radius, color2, fill = false) {
-      if (!isFiniteNumber6(cx) || !isFiniteNumber6(cy) || !isFiniteNumber6(radius)) return;
+      if (!isFiniteNumber7(cx) || !isFiniteNumber7(cy) || !isFiniteNumber7(radius)) return;
       if (radius <= 0) return;
       const x0 = Math.max(0, Math.floor(cx - radius - 1));
       const y0 = Math.max(0, Math.floor(cy - radius - 1));
@@ -5565,7 +5881,7 @@ var createCanvas = (width, height, fillColor = null) => {
       }
     },
     drawSprite(x, y, sprite) {
-      if (!isFiniteNumber6(x) || !isFiniteNumber6(y)) return;
+      if (!isFiniteNumber7(x) || !isFiniteNumber7(y)) return;
       if (!Array.isArray(sprite)) return;
       const sx = Math.floor(x);
       const sy = Math.floor(y);
@@ -6322,6 +6638,99 @@ var withConfig = (overrides, fn) => {
     throw err;
   }
 };
+var setConfigValue = (key, value) => {
+  configure({ [key]: value });
+};
+var subscribeConfig = onConfigChange;
+
+// src/utils/easing.ts
+var c1 = 1.70158;
+var c2 = c1 * 1.525;
+var c3 = c1 + 1;
+var c4 = 2 * Math.PI / 3;
+var c5 = 2 * Math.PI / 4.5;
+var _bounceOut = (t) => {
+  const n1 = 7.5625;
+  const d1 = 2.75;
+  if (t < 1 / d1) return n1 * t * t;
+  if (t < 2 / d1) {
+    const x2 = t - 1.5 / d1;
+    return n1 * x2 * x2 + 0.75;
+  }
+  if (t < 2.5 / d1) {
+    const x2 = t - 2.25 / d1;
+    return n1 * x2 * x2 + 0.9375;
+  }
+  const x = t - 2.625 / d1;
+  return n1 * x * x + 0.984375;
+};
+var easings = {
+  // ── Linear ──
+  linear: (t) => t,
+  // ── Quadratic (t²) ──
+  easeInQuad: (t) => t * t,
+  easeOutQuad: (t) => 1 - (1 - t) * (1 - t),
+  easeInOutQuad: (t) => t < 0.5 ? 2 * t * t : 1 - Math.pow(-2 * t + 2, 2) / 2,
+  // ── Cubic (t³) ──
+  easeInCubic: (t) => t * t * t,
+  easeOutCubic: (t) => 1 - Math.pow(1 - t, 3),
+  easeInOutCubic: (t) => t < 0.5 ? 4 * t * t * t : 1 - Math.pow(-2 * t + 2, 3) / 2,
+  // ── Quartic (t⁴) ──
+  easeInQuart: (t) => t * t * t * t,
+  easeOutQuart: (t) => 1 - Math.pow(1 - t, 4),
+  easeInOutQuart: (t) => t < 0.5 ? 8 * t * t * t * t : 1 - Math.pow(-2 * t + 2, 4) / 2,
+  // ── Quintic (t⁵) ──
+  easeInQuint: (t) => t * t * t * t * t,
+  easeOutQuint: (t) => 1 - Math.pow(1 - t, 5),
+  easeInOutQuint: (t) => t < 0.5 ? 16 * t * t * t * t * t : 1 - Math.pow(-2 * t + 2, 5) / 2,
+  // ── Sinusoidal ──
+  easeInSine: (t) => 1 - Math.cos(t * Math.PI / 2),
+  easeOutSine: (t) => Math.sin(t * Math.PI / 2),
+  easeInOutSine: (t) => -(Math.cos(Math.PI * t) - 1) / 2,
+  // ── Exponential ──
+  easeInExpo: (t) => t === 0 ? 0 : Math.pow(2, 10 * t - 10),
+  easeOutExpo: (t) => t === 1 ? 1 : 1 - Math.pow(2, -10 * t),
+  easeInOutExpo: (t) => {
+    if (t === 0) return 0;
+    if (t === 1) return 1;
+    return t < 0.5 ? Math.pow(2, 20 * t - 10) / 2 : (2 - Math.pow(2, -20 * t + 10)) / 2;
+  },
+  // ── Circular ──
+  easeInCirc: (t) => 1 - Math.sqrt(1 - Math.pow(t, 2)),
+  easeOutCirc: (t) => Math.sqrt(1 - Math.pow(t - 1, 2)),
+  easeInOutCirc: (t) => t < 0.5 ? (1 - Math.sqrt(1 - Math.pow(2 * t, 2))) / 2 : (Math.sqrt(1 - Math.pow(-2 * t + 2, 2)) + 1) / 2,
+  // ── Back (overshoots) ──
+  easeInBack: (t) => c3 * t * t * t - c1 * t * t,
+  easeOutBack: (t) => 1 + c3 * Math.pow(t - 1, 3) + c1 * Math.pow(t - 1, 2),
+  easeInOutBack: (t) => t < 0.5 ? Math.pow(2 * t, 2) * ((c2 + 1) * 2 * t - c2) / 2 : (Math.pow(2 * t - 2, 2) * ((c2 + 1) * (t * 2 - 2) + c2) + 2) / 2,
+  // ── Elastic (oscillates) ──
+  easeInElastic: (t) => {
+    if (t === 0) return 0;
+    if (t === 1) return 1;
+    return -Math.pow(2, 10 * t - 10) * Math.sin((t * 10 - 10.75) * c4);
+  },
+  easeOutElastic: (t) => {
+    if (t === 0) return 0;
+    if (t === 1) return 1;
+    return Math.pow(2, -10 * t) * Math.sin((t * 10 - 0.75) * c4) + 1;
+  },
+  easeInOutElastic: (t) => {
+    if (t === 0) return 0;
+    if (t === 1) return 1;
+    return t < 0.5 ? -(Math.pow(2, 20 * t - 10) * Math.sin((20 * t - 11.125) * c5)) / 2 : Math.pow(2, -20 * t + 10) * Math.sin((20 * t - 11.125) * c5) / 2 + 1;
+  },
+  // ── Bounce (bouncing ball) ──
+  easeInBounce: (t) => 1 - _bounceOut(1 - t),
+  easeOutBounce: _bounceOut,
+  easeInOutBounce: (t) => t < 0.5 ? (1 - _bounceOut(1 - 2 * t)) / 2 : (1 + _bounceOut(2 * t - 1)) / 2
+};
+var resolveEasingByName = (e) => {
+  if (typeof e === "function") return e;
+  if (typeof e === "string" && easings[e]) {
+    return easings[e];
+  }
+  return easings.linear;
+};
 
 // src/index.ts
 var ansimax = { color, animate, ascii, loader, frames, components, trees, themes, images, configure };
@@ -6358,8 +6767,10 @@ var index_default = ansimax;
   chain,
   charWidth,
   clamp,
+  clampByte,
   clearAnsiCache,
   clearColorCache,
+  clearLine,
   clearRenderCache,
   clearThemeColorCache,
   color,
@@ -6376,6 +6787,8 @@ var index_default = ansimax;
   cursor,
   debounce,
   diffLines,
+  easings,
+  escapeForRegex,
   escapeRegex,
   fg256,
   fgRgb,
@@ -6396,13 +6809,17 @@ var index_default = ansimax;
   gradient,
   gradientColor,
   gradientRect,
+  gradientStops,
   graphemes,
   grid,
   hasFont,
   hexToRgb,
   hideCursor,
+  hslToRgb,
   hsplit,
+  hyperlink,
   images,
+  isFiniteNumber,
   isHexColor,
   isNoColor,
   json,
@@ -6414,9 +6831,12 @@ var index_default = ansimax;
   listPresets,
   loader,
   mapTree,
+  measureBlock,
   measureTree,
   memoize,
+  mixColors,
   nextTick,
+  oklabToRgb,
   onConfigChange,
   onConfigKeyChange,
   onResize,
@@ -6429,6 +6849,7 @@ var index_default = ansimax;
   pauseListeners,
   presetNames,
   presets,
+  quantizeColor,
   rainbow,
   registerFont,
   registerPreset,
@@ -6444,13 +6865,18 @@ var index_default = ansimax;
   resetFramesCursorCount,
   resetLoaderCursorCount,
   resetNoColor,
+  resolveEasingByName,
   resumeListeners,
   reverseGradient,
   rgbTo256,
   rgbToHex,
+  rgbToHsl,
+  rgbToOklab,
   rotate90,
+  safeInt,
   safeJson,
   screen,
+  setConfigValue,
   setNoColor,
   setTitle,
   sgr,
@@ -6461,6 +6887,7 @@ var index_default = ansimax;
   stripAnsi,
   stripAnsiCodes,
   stripAnsiColors,
+  subscribeConfig,
   supportsColor,
   supportsColorLevel,
   termSize,