ansimax 1.3.3 → 1.3.4

package/dist/index.js

@@ -62,6 +62,7 @@ __export(index_exports, {
   clamp: () => clamp,
   clearAnsiCache: () => clearAnsiCache,
   clearColorCache: () => clearColorCache,
+  clearLine: () => clearLine,
   clearRenderCache: () => clearRenderCache,
   clearThemeColorCache: () => clearThemeColorCache,
   color: () => color,
@@ -79,6 +80,7 @@ __export(index_exports, {
   debounce: () => debounce,
   default: () => index_default,
   diffLines: () => diffLines,
+  escapeForRegex: () => escapeForRegex,
   escapeRegex: () => escapeRegex,
   fg256: () => fg256,
   fgRgb: () => fgRgb,
@@ -99,12 +101,14 @@ __export(index_exports, {
   gradient: () => gradient,
   gradientColor: () => gradientColor,
   gradientRect: () => gradientRect,
+  gradientStops: () => gradientStops,
   graphemes: () => graphemes,
   grid: () => grid,
   hasFont: () => hasFont,
   hexToRgb: () => hexToRgb,
   hideCursor: () => hideCursor,
   hsplit: () => hsplit,
+  hyperlink: () => hyperlink,
   images: () => images,
   isHexColor: () => isHexColor,
   isNoColor: () => isNoColor,
@@ -117,6 +121,7 @@ __export(index_exports, {
   listPresets: () => listPresets,
   loader: () => loader,
   mapTree: () => mapTree,
+  measureBlock: () => measureBlock,
   measureTree: () => measureTree,
   memoize: () => memoize,
   nextTick: () => nextTick,
@@ -154,6 +159,7 @@ __export(index_exports, {
   rotate90: () => rotate90,
   safeJson: () => safeJson,
   screen: () => screen,
+  setConfigValue: () => setConfigValue,
   setNoColor: () => setNoColor,
   setTitle: () => setTitle,
   sgr: () => sgr,
@@ -164,6 +170,7 @@ __export(index_exports, {
   stripAnsi: () => stripAnsi2,
   stripAnsiCodes: () => stripAnsi,
   stripAnsiColors: () => stripAnsi3,
+  subscribeConfig: () => subscribeConfig,
   supportsColor: () => supportsColor,
   supportsColorLevel: () => supportsColorLevel,
   termSize: () => termSize,
@@ -567,6 +574,14 @@ 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 clamp = (n, min, max) => Math.min(Math.max(n, min), max);
@@ -989,6 +1004,35 @@ var padBoth = (str, width, ch = " ") => {
   const r = pad - l;
   return ch.repeat(l) + str + ch.repeat(r);
 };
+var gradientStops = (start, end, count) => {
+  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);
+    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;
@@ -2112,6 +2156,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 +2293,10 @@ var animate = {
   sequence,
   chain: chain2,
   parallel,
-  delay
+  delay,
+  // v1.3.4
+  shake,
+  countUp
 };
 
 // src/ascii/index.ts
@@ -4053,7 +4225,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,8 +4235,8 @@ 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);
+  if (Array.isArray(gradientStops2) && gradientStops2.length >= 1 && filled > 0) {
+    filledStr = gradient(filledStr, gradientStops2);
   } else if (color2 !== null && isFiniteNumber4(color2)) {
     filledStr = sgr(safeSgrCode(color2, FG.white)) + filledStr + reset();
   }
@@ -6322,6 +6494,10 @@ var withConfig = (overrides, fn) => {
     throw err;
   }
 };
+var setConfigValue = (key, value) => {
+  configure({ [key]: value });
+};
+var subscribeConfig = onConfigChange;
 
 // src/index.ts
 var ansimax = { color, animate, ascii, loader, frames, components, trees, themes, images, configure };
@@ -6360,6 +6536,7 @@ var index_default = ansimax;
   clamp,
   clearAnsiCache,
   clearColorCache,
+  clearLine,
   clearRenderCache,
   clearThemeColorCache,
   color,
@@ -6376,6 +6553,7 @@ var index_default = ansimax;
   cursor,
   debounce,
   diffLines,
+  escapeForRegex,
   escapeRegex,
   fg256,
   fgRgb,
@@ -6396,12 +6574,14 @@ var index_default = ansimax;
   gradient,
   gradientColor,
   gradientRect,
+  gradientStops,
   graphemes,
   grid,
   hasFont,
   hexToRgb,
   hideCursor,
   hsplit,
+  hyperlink,
   images,
   isHexColor,
   isNoColor,
@@ -6414,6 +6594,7 @@ var index_default = ansimax;
   listPresets,
   loader,
   mapTree,
+  measureBlock,
   measureTree,
   memoize,
   nextTick,
@@ -6451,6 +6632,7 @@ var index_default = ansimax;
   rotate90,
   safeJson,
   screen,
+  setConfigValue,
   setNoColor,
   setTitle,
   sgr,
@@ -6461,6 +6643,7 @@ var index_default = ansimax;
   stripAnsi,
   stripAnsiCodes,
   stripAnsiColors,
+  subscribeConfig,
   supportsColor,
   supportsColorLevel,
   termSize,

package/dist/index.mjs

@@ -379,6 +379,14 @@ 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 clamp = (n, min, max) => Math.min(Math.max(n, min), max);
@@ -801,6 +809,35 @@ var padBoth = (str, width, ch = " ") => {
   const r = pad - l;
   return ch.repeat(l) + str + ch.repeat(r);
 };
+var gradientStops = (start, end, count) => {
+  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);
+    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;
@@ -1924,6 +1961,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,
@@ -1936,7 +2098,10 @@ var animate = {
   sequence,
   chain: chain2,
   parallel,
-  delay
+  delay,
+  // v1.3.4
+  shake,
+  countUp
 };
 
 // src/ascii/index.ts
@@ -3865,7 +4030,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";
@@ -3875,8 +4040,8 @@ 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);
+  if (Array.isArray(gradientStops2) && gradientStops2.length >= 1 && filled > 0) {
+    filledStr = gradient(filledStr, gradientStops2);
   } else if (color2 !== null && isFiniteNumber4(color2)) {
     filledStr = sgr(safeSgrCode(color2, FG.white)) + filledStr + reset();
   }
@@ -6134,6 +6299,10 @@ var withConfig = (overrides, fn) => {
     throw err;
   }
 };
+var setConfigValue = (key, value) => {
+  configure({ [key]: value });
+};
+var subscribeConfig = onConfigChange;
 
 // src/index.ts
 var ansimax = { color, animate, ascii, loader, frames, components, trees, themes, images, configure };
@@ -6171,6 +6340,7 @@ export {
   clamp,
   clearAnsiCache,
   clearColorCache,
+  clearLine,
   clearRenderCache,
   clearThemeColorCache,
   color,
@@ -6188,6 +6358,7 @@ export {
   debounce,
   index_default as default,
   diffLines,
+  escapeForRegex,
   escapeRegex,
   fg256,
   fgRgb,
@@ -6208,12 +6379,14 @@ export {
   gradient,
   gradientColor,
   gradientRect,
+  gradientStops,
   graphemes,
   grid,
   hasFont,
   hexToRgb,
   hideCursor,
   hsplit,
+  hyperlink,
   images,
   isHexColor,
   isNoColor,
@@ -6226,6 +6399,7 @@ export {
   listPresets,
   loader,
   mapTree,
+  measureBlock,
   measureTree,
   memoize,
   nextTick,
@@ -6263,6 +6437,7 @@ export {
   rotate90,
   safeJson,
   screen,
+  setConfigValue,
   setNoColor,
   setTitle,
   sgr,
@@ -6273,6 +6448,7 @@ export {
   stripAnsi2 as stripAnsi,
   stripAnsi as stripAnsiCodes,
   stripAnsi3 as stripAnsiColors,
+  subscribeConfig,
   supportsColor,
   supportsColorLevel,
   termSize,

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ansimax",
-  "version": "1.3.3",
+  "version": "1.3.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",