ansimax 1.1.1 → 1.2.0

package/dist/index.js

@@ -46,6 +46,7 @@ __export(index_exports, {
   ST: () => ST,
   STYLE: () => STYLE,
   animate: () => animate,
+  animateGradient: () => animateGradient,
   ascii: () => ascii,
   bell: () => bell,
   bg256: () => bg256,
@@ -225,6 +226,11 @@ var cursor = {
 var _exitHandlerRegistered = false;
 var _isTestEnv = () => process.env["JEST_WORKER_ID"] !== void 0 || process.env["VITEST"] !== void 0 || process.env["NODE_ENV"] === "test";
 var _installCursorRestoreImpl = () => {
+  try {
+    const current = process.getMaxListeners?.() ?? 10;
+    if (current < 20) process.setMaxListeners?.(20);
+  } catch {
+  }
   const restore = () => {
     try {
       safeStreamWrite(process.stdout, cursor.show());
@@ -1109,6 +1115,37 @@ var compose = (...fns) => (text) => {
   if (opens === "") return s;
   return opens + s + reset();
 };
+var _cubicBezier = (t, x1 = 0.25, y1 = 0.1, x2 = 0.25, y2 = 1) => {
+  if (t <= 0) return 0;
+  if (t >= 1) return 1;
+  let s = t;
+  for (let i = 0; i < 8; i++) {
+    const s22 = s * s;
+    const s32 = s22 * s;
+    const oneMinusS = 1 - s;
+    const oneMinusS2 = oneMinusS * oneMinusS;
+    const fx = 3 * oneMinusS2 * s * x1 + 3 * oneMinusS * s22 * x2 + s32 - t;
+    const dfx = 3 * oneMinusS2 * x1 + 6 * oneMinusS * s * (x2 - x1) + 3 * s22 * (1 - x2);
+    if (Math.abs(dfx) < 1e-6) break;
+    s -= fx / dfx;
+    s = Math.min(1, Math.max(0, s));
+  }
+  const s2 = s * s;
+  const s3 = s2 * s;
+  return 3 * (1 - s) * (1 - s) * s * y1 + 3 * (1 - s) * s2 * y2 + s3;
+};
+var EASINGS = {
+  "linear": (t) => t,
+  "ease-in": (t) => t * t,
+  "ease-out": (t) => 1 - (1 - t) * (1 - t),
+  "ease-in-out": (t) => t < 0.5 ? 2 * t * t : 1 - Math.pow(-2 * t + 2, 2) / 2,
+  "cubic-bezier": (t) => _cubicBezier(t)
+};
+var resolveEasing = (e) => {
+  if (typeof e === "function") return e;
+  if (typeof e === "string" && EASINGS[e]) return EASINGS[e];
+  return EASINGS.linear;
+};
 var stripAnsi3 = stripAnsi;
 var gradient = (text, stops, opts = {}) => {
   const s = coerceText(text);
@@ -1120,13 +1157,15 @@ var gradient = (text, stops, opts = {}) => {
     const c = colors[0];
     return adaptiveFg(c.r, c.g, c.b) + s + reset();
   }
-  const { preserveAnsi = false } = opts;
+  const { preserveAnsi = false, easing, phase = 0 } = opts;
+  const easingFn = resolveEasing(easing);
+  const phaseN = Number.isFinite(phase) ? (phase % 1 + 1) % 1 : 0;
   if (!preserveAnsi || !s.includes("\x1B")) {
-    return _gradientPlain(s, colors);
+    return _gradientPlain(s, colors, easingFn, phaseN);
   }
-  return _gradientAnsiAware(s, colors);
+  return _gradientAnsiAware(s, colors, easingFn, phaseN);
 };
-var _gradientPlain = (text, colors) => {
+var _gradientPlain = (text, colors, easingFn, phase) => {
   const chars = [...text];
   const visible = chars.filter((c) => c !== " ").length;
   if (visible === 0) return text;
@@ -1139,7 +1178,10 @@ var _gradientPlain = (text, colors) => {
       out += ch;
       continue;
     }
-    const t = visible === 1 ? 0 : colorIdx / visibleMinus;
+    let t = visible === 1 ? 0 : colorIdx / visibleMinus;
+    t = (t + phase) % 1;
+    t = easingFn(t);
+    t = Math.min(1, Math.max(0, t));
     const scaled = t * (colorCount - 1);
     const lo = Math.floor(scaled);
     const hi = Math.min(lo + 1, colorCount - 1);
@@ -1150,7 +1192,7 @@ var _gradientPlain = (text, colors) => {
   return out;
 };
 var ANSI_TOKEN = /\x1b\[[0-9;?]*[a-zA-Z]/y;
-var _gradientAnsiAware = (text, colors) => {
+var _gradientAnsiAware = (text, colors, easingFn, phase) => {
   const visible = stripAnsi3(text).split("").filter((c) => c !== " ").length;
   if (visible === 0) return text;
   let out = "";
@@ -1176,7 +1218,10 @@ var _gradientAnsiAware = (text, colors) => {
     if (ch === " ") {
       out += ch;
     } else {
-      const t = visible === 1 ? 0 : colorIdx / visibleMinus;
+      let t = visible === 1 ? 0 : colorIdx / visibleMinus;
+      t = (t + phase) % 1;
+      t = easingFn(t);
+      t = Math.min(1, Math.max(0, t));
       const scaled = t * (colorCount - 1);
       const lo = Math.floor(scaled);
       const hi = Math.min(lo + 1, colorCount - 1);
@@ -1190,6 +1235,76 @@ var _gradientAnsiAware = (text, colors) => {
 };
 var RAINBOW = ["#ff0000", "#ff7f00", "#ffff00", "#00ff00", "#0000ff", "#8b00ff"];
 var rainbow = (text) => gradient(text, RAINBOW);
+var animateGradient = (text, stops, opts = {}) => {
+  const {
+    duration = 2e3,
+    fps = 30,
+    infinite = true,
+    cycles = 1,
+    direction = "forward",
+    easing,
+    preserveAnsi = false,
+    signal,
+    onFrame
+  } = opts;
+  const safeFps = Math.min(60, Math.max(1, Number.isFinite(fps) ? fps : 30));
+  const safeDuration2 = Math.max(100, Number.isFinite(duration) ? duration : 2e3);
+  const safeCycles = Math.max(1, Number.isFinite(cycles) ? cycles : 1);
+  const frameInterval2 = 1e3 / safeFps;
+  let stopped = false;
+  let timer = null;
+  let resolveDone = (
+    /* istanbul ignore next */
+    () => {
+    }
+  );
+  const done = new Promise((res) => {
+    resolveDone = res;
+  });
+  const stop = () => {
+    if (stopped) return;
+    stopped = true;
+    if (timer != null) {
+      clearInterval(timer);
+      timer = null;
+    }
+    resolveDone();
+  };
+  if (signal) {
+    if (signal.aborted) {
+      stop();
+      return { stop, done };
+    }
+    signal.addEventListener("abort", stop, { once: true });
+  }
+  const startTime = Date.now();
+  const renderFrame = () => {
+    if (stopped) return;
+    const elapsed = Date.now() - startTime;
+    let phase = elapsed / safeDuration2 % 1;
+    if (direction === "reverse") phase = 1 - phase;
+    const frame = gradient(text, stops, { preserveAnsi, easing, phase });
+    if (onFrame) {
+      onFrame(frame, phase);
+    } else {
+      try {
+        process.stdout.write("\r" + frame);
+      } catch {
+      }
+    }
+    if (!infinite) {
+      const completedCycles = Math.floor(elapsed / safeDuration2);
+      if (completedCycles >= safeCycles) {
+        stop();
+      }
+    }
+  };
+  renderFrame();
+  if (!stopped) {
+    timer = setInterval(renderFrame, frameInterval2);
+  }
+  return { stop, done };
+};
 var PRESET_DEFS = {
   sunset: ["#ff6b6b", "#feca57", "#48dbfb"],
   ocean: ["#0575e6", "#021b79"],
@@ -4113,12 +4228,12 @@ var validateTheme = (t) => {
   }
   const obj = t;
   if (typeof obj.name !== "string" || obj.name.length === 0) {
-    throw new Error('Theme must have a non-empty "name" string.');
+    throw new TypeError('Theme must have a non-empty "name" string.');
   }
   for (const key of REQUIRED_COLOR_KEYS) {
     const value = obj[key];
     if (typeof value !== "string" || !HEX_RE4.test(value)) {
-      throw new Error(
+      throw new TypeError(
         `Invalid hex in theme "${obj.name}" \u2192 ${key}: ${JSON.stringify(value)}. Expected #RGB or #RRGGBB.`
       );
     }
@@ -4127,20 +4242,20 @@ var validateTheme = (t) => {
     const value = obj[key];
     if (value === void 0) continue;
     if (typeof value !== "string" || !HEX_RE4.test(value)) {
-      throw new Error(
+      throw new TypeError(
         `Invalid hex in theme "${obj.name}" \u2192 ${key}: ${JSON.stringify(value)}.`
       );
     }
   }
   if (!Array.isArray(obj.gradient) || obj.gradient.length < 2) {
-    throw new Error(
+    throw new TypeError(
       `Theme "${obj.name}" must define a "gradient" array with at least 2 colors.`
     );
   }
   for (let i = 0; i < obj.gradient.length; i++) {
     const stop = obj.gradient[i];
     if (typeof stop !== "string" || !HEX_RE4.test(stop)) {
-      throw new Error(
+      throw new TypeError(
         `Invalid hex in theme "${obj.name}" \u2192 gradient[${i}]: ${JSON.stringify(stop)}.`
       );
     }
@@ -4452,8 +4567,8 @@ var themes = {
   use(name) {
     const t = _globalRegistry.get(name);
     if (!t) {
-      throw new Error(
-        `Theme "${name}" not found. Available: ${[..._globalRegistry.keys()].join(", ")}`
+      throw new RangeError(
+        `Theme "${name}" not found. Available themes: ${[..._globalRegistry.keys()].join(", ")}`
       );
     }
     const old = _globalActive;
@@ -4828,6 +4943,7 @@ var gradientRect = (opts = {}) => {
     colors = ["#ff0000", "#0000ff"],
     style = "horizontal",
     angle,
+    startAngle = 0,
     dither = "none",
     braille = false
   } = opts;
@@ -4866,7 +4982,15 @@ var gradientRect = (opts = {}) => {
       } else if (style === "horizontal") t = col / (safeW - 1);
       else if (style === "vertical") t = row / (safeH - 1);
       else if (style === "diagonal") t = (col + row) / (safeW + safeH - 2);
-      else {
+      else if (style === "conic") {
+        const cx = safeW / 2, cy = safeH / 2;
+        const dx = col - cx;
+        const dy = row - cy;
+        const startRad = (Number.isFinite(startAngle) ? startAngle : 0) * Math.PI / 180;
+        let angleRad = Math.atan2(dy, dx) - startRad;
+        angleRad = (angleRad % (2 * Math.PI) + 2 * Math.PI) % (2 * Math.PI);
+        t = angleRad / (2 * Math.PI);
+      } else {
         const cx = safeW / 2, cy = safeH / 2;
         const dx = (col - cx) / cx;
         const dy = (row - cy) / cy;
@@ -5318,6 +5442,7 @@ var index_default = ansimax;
   ST,
   STYLE,
   animate,
+  animateGradient,
   ascii,
   bell,
   bg256,

package/dist/index.mjs

@@ -53,6 +53,11 @@ var cursor = {
 var _exitHandlerRegistered = false;
 var _isTestEnv = () => process.env["JEST_WORKER_ID"] !== void 0 || process.env["VITEST"] !== void 0 || process.env["NODE_ENV"] === "test";
 var _installCursorRestoreImpl = () => {
+  try {
+    const current = process.getMaxListeners?.() ?? 10;
+    if (current < 20) process.setMaxListeners?.(20);
+  } catch {
+  }
   const restore = () => {
     try {
       safeStreamWrite(process.stdout, cursor.show());
@@ -937,6 +942,37 @@ var compose = (...fns) => (text) => {
   if (opens === "") return s;
   return opens + s + reset();
 };
+var _cubicBezier = (t, x1 = 0.25, y1 = 0.1, x2 = 0.25, y2 = 1) => {
+  if (t <= 0) return 0;
+  if (t >= 1) return 1;
+  let s = t;
+  for (let i = 0; i < 8; i++) {
+    const s22 = s * s;
+    const s32 = s22 * s;
+    const oneMinusS = 1 - s;
+    const oneMinusS2 = oneMinusS * oneMinusS;
+    const fx = 3 * oneMinusS2 * s * x1 + 3 * oneMinusS * s22 * x2 + s32 - t;
+    const dfx = 3 * oneMinusS2 * x1 + 6 * oneMinusS * s * (x2 - x1) + 3 * s22 * (1 - x2);
+    if (Math.abs(dfx) < 1e-6) break;
+    s -= fx / dfx;
+    s = Math.min(1, Math.max(0, s));
+  }
+  const s2 = s * s;
+  const s3 = s2 * s;
+  return 3 * (1 - s) * (1 - s) * s * y1 + 3 * (1 - s) * s2 * y2 + s3;
+};
+var EASINGS = {
+  "linear": (t) => t,
+  "ease-in": (t) => t * t,
+  "ease-out": (t) => 1 - (1 - t) * (1 - t),
+  "ease-in-out": (t) => t < 0.5 ? 2 * t * t : 1 - Math.pow(-2 * t + 2, 2) / 2,
+  "cubic-bezier": (t) => _cubicBezier(t)
+};
+var resolveEasing = (e) => {
+  if (typeof e === "function") return e;
+  if (typeof e === "string" && EASINGS[e]) return EASINGS[e];
+  return EASINGS.linear;
+};
 var stripAnsi3 = stripAnsi;
 var gradient = (text, stops, opts = {}) => {
   const s = coerceText(text);
@@ -948,13 +984,15 @@ var gradient = (text, stops, opts = {}) => {
     const c = colors[0];
     return adaptiveFg(c.r, c.g, c.b) + s + reset();
   }
-  const { preserveAnsi = false } = opts;
+  const { preserveAnsi = false, easing, phase = 0 } = opts;
+  const easingFn = resolveEasing(easing);
+  const phaseN = Number.isFinite(phase) ? (phase % 1 + 1) % 1 : 0;
   if (!preserveAnsi || !s.includes("\x1B")) {
-    return _gradientPlain(s, colors);
+    return _gradientPlain(s, colors, easingFn, phaseN);
   }
-  return _gradientAnsiAware(s, colors);
+  return _gradientAnsiAware(s, colors, easingFn, phaseN);
 };
-var _gradientPlain = (text, colors) => {
+var _gradientPlain = (text, colors, easingFn, phase) => {
   const chars = [...text];
   const visible = chars.filter((c) => c !== " ").length;
   if (visible === 0) return text;
@@ -967,7 +1005,10 @@ var _gradientPlain = (text, colors) => {
       out += ch;
       continue;
     }
-    const t = visible === 1 ? 0 : colorIdx / visibleMinus;
+    let t = visible === 1 ? 0 : colorIdx / visibleMinus;
+    t = (t + phase) % 1;
+    t = easingFn(t);
+    t = Math.min(1, Math.max(0, t));
     const scaled = t * (colorCount - 1);
     const lo = Math.floor(scaled);
     const hi = Math.min(lo + 1, colorCount - 1);
@@ -978,7 +1019,7 @@ var _gradientPlain = (text, colors) => {
   return out;
 };
 var ANSI_TOKEN = /\x1b\[[0-9;?]*[a-zA-Z]/y;
-var _gradientAnsiAware = (text, colors) => {
+var _gradientAnsiAware = (text, colors, easingFn, phase) => {
   const visible = stripAnsi3(text).split("").filter((c) => c !== " ").length;
   if (visible === 0) return text;
   let out = "";
@@ -1004,7 +1045,10 @@ var _gradientAnsiAware = (text, colors) => {
     if (ch === " ") {
       out += ch;
     } else {
-      const t = visible === 1 ? 0 : colorIdx / visibleMinus;
+      let t = visible === 1 ? 0 : colorIdx / visibleMinus;
+      t = (t + phase) % 1;
+      t = easingFn(t);
+      t = Math.min(1, Math.max(0, t));
       const scaled = t * (colorCount - 1);
       const lo = Math.floor(scaled);
       const hi = Math.min(lo + 1, colorCount - 1);
@@ -1018,6 +1062,76 @@ var _gradientAnsiAware = (text, colors) => {
 };
 var RAINBOW = ["#ff0000", "#ff7f00", "#ffff00", "#00ff00", "#0000ff", "#8b00ff"];
 var rainbow = (text) => gradient(text, RAINBOW);
+var animateGradient = (text, stops, opts = {}) => {
+  const {
+    duration = 2e3,
+    fps = 30,
+    infinite = true,
+    cycles = 1,
+    direction = "forward",
+    easing,
+    preserveAnsi = false,
+    signal,
+    onFrame
+  } = opts;
+  const safeFps = Math.min(60, Math.max(1, Number.isFinite(fps) ? fps : 30));
+  const safeDuration2 = Math.max(100, Number.isFinite(duration) ? duration : 2e3);
+  const safeCycles = Math.max(1, Number.isFinite(cycles) ? cycles : 1);
+  const frameInterval2 = 1e3 / safeFps;
+  let stopped = false;
+  let timer = null;
+  let resolveDone = (
+    /* istanbul ignore next */
+    () => {
+    }
+  );
+  const done = new Promise((res) => {
+    resolveDone = res;
+  });
+  const stop = () => {
+    if (stopped) return;
+    stopped = true;
+    if (timer != null) {
+      clearInterval(timer);
+      timer = null;
+    }
+    resolveDone();
+  };
+  if (signal) {
+    if (signal.aborted) {
+      stop();
+      return { stop, done };
+    }
+    signal.addEventListener("abort", stop, { once: true });
+  }
+  const startTime = Date.now();
+  const renderFrame = () => {
+    if (stopped) return;
+    const elapsed = Date.now() - startTime;
+    let phase = elapsed / safeDuration2 % 1;
+    if (direction === "reverse") phase = 1 - phase;
+    const frame = gradient(text, stops, { preserveAnsi, easing, phase });
+    if (onFrame) {
+      onFrame(frame, phase);
+    } else {
+      try {
+        process.stdout.write("\r" + frame);
+      } catch {
+      }
+    }
+    if (!infinite) {
+      const completedCycles = Math.floor(elapsed / safeDuration2);
+      if (completedCycles >= safeCycles) {
+        stop();
+      }
+    }
+  };
+  renderFrame();
+  if (!stopped) {
+    timer = setInterval(renderFrame, frameInterval2);
+  }
+  return { stop, done };
+};
 var PRESET_DEFS = {
   sunset: ["#ff6b6b", "#feca57", "#48dbfb"],
   ocean: ["#0575e6", "#021b79"],
@@ -3941,12 +4055,12 @@ var validateTheme = (t) => {
   }
   const obj = t;
   if (typeof obj.name !== "string" || obj.name.length === 0) {
-    throw new Error('Theme must have a non-empty "name" string.');
+    throw new TypeError('Theme must have a non-empty "name" string.');
   }
   for (const key of REQUIRED_COLOR_KEYS) {
     const value = obj[key];
     if (typeof value !== "string" || !HEX_RE4.test(value)) {
-      throw new Error(
+      throw new TypeError(
         `Invalid hex in theme "${obj.name}" \u2192 ${key}: ${JSON.stringify(value)}. Expected #RGB or #RRGGBB.`
       );
     }
@@ -3955,20 +4069,20 @@ var validateTheme = (t) => {
     const value = obj[key];
     if (value === void 0) continue;
     if (typeof value !== "string" || !HEX_RE4.test(value)) {
-      throw new Error(
+      throw new TypeError(
         `Invalid hex in theme "${obj.name}" \u2192 ${key}: ${JSON.stringify(value)}.`
       );
     }
   }
   if (!Array.isArray(obj.gradient) || obj.gradient.length < 2) {
-    throw new Error(
+    throw new TypeError(
       `Theme "${obj.name}" must define a "gradient" array with at least 2 colors.`
     );
   }
   for (let i = 0; i < obj.gradient.length; i++) {
     const stop = obj.gradient[i];
     if (typeof stop !== "string" || !HEX_RE4.test(stop)) {
-      throw new Error(
+      throw new TypeError(
         `Invalid hex in theme "${obj.name}" \u2192 gradient[${i}]: ${JSON.stringify(stop)}.`
       );
     }
@@ -4280,8 +4394,8 @@ var themes = {
   use(name) {
     const t = _globalRegistry.get(name);
     if (!t) {
-      throw new Error(
-        `Theme "${name}" not found. Available: ${[..._globalRegistry.keys()].join(", ")}`
+      throw new RangeError(
+        `Theme "${name}" not found. Available themes: ${[..._globalRegistry.keys()].join(", ")}`
       );
     }
     const old = _globalActive;
@@ -4656,6 +4770,7 @@ var gradientRect = (opts = {}) => {
     colors = ["#ff0000", "#0000ff"],
     style = "horizontal",
     angle,
+    startAngle = 0,
     dither = "none",
     braille = false
   } = opts;
@@ -4694,7 +4809,15 @@ var gradientRect = (opts = {}) => {
       } else if (style === "horizontal") t = col / (safeW - 1);
       else if (style === "vertical") t = row / (safeH - 1);
       else if (style === "diagonal") t = (col + row) / (safeW + safeH - 2);
-      else {
+      else if (style === "conic") {
+        const cx = safeW / 2, cy = safeH / 2;
+        const dx = col - cx;
+        const dy = row - cy;
+        const startRad = (Number.isFinite(startAngle) ? startAngle : 0) * Math.PI / 180;
+        let angleRad = Math.atan2(dy, dx) - startRad;
+        angleRad = (angleRad % (2 * Math.PI) + 2 * Math.PI) % (2 * Math.PI);
+        t = angleRad / (2 * Math.PI);
+      } else {
         const cx = safeW / 2, cy = safeH / 2;
         const dx = (col - cx) / cx;
         const dy = (row - cy) / cy;
@@ -5145,6 +5268,7 @@ export {
   ST,
   STYLE,
   animate,
+  animateGradient,
   ascii,
   bell,
   bg256,

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.1.1'),
+    components.badge('VERSION', 'v1.2.0'),
     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.1.1'),
+  components.badge('VERSION', 'v1.2.0'),
   components.badge('BUILD', 'passing'),
   components.badge('LICENSE', 'Apache 2.0'));
 console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ansimax",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "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",