ansimax 1.0.0

package/dist/index.js

@@ -0,0 +1,1707 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  SPINNERS: () => SPINNERS,
+  SPRITES: () => SPRITES,
+  animate: () => animate,
+  ascii: () => ascii,
+  bgRgb: () => bgRgb,
+  center: () => center,
+  clamp: () => clamp,
+  color: () => color,
+  colorPresets: () => presets,
+  components: () => components,
+  compose: () => compose,
+  configure: () => configure,
+  createCanvas: () => createCanvas,
+  cursor: () => cursor,
+  default: () => index_default,
+  fgRgb: () => fgRgb,
+  frames: () => frames,
+  getConfig: () => getConfig,
+  getSpeedMultiplier: () => getSpeedMultiplier,
+  gradient: () => gradient,
+  gradientRect: () => gradientRect,
+  hexToRgb: () => hexToRgb,
+  images: () => images,
+  isHexColor: () => isHexColor,
+  isNoColor: () => isNoColor,
+  lerp: () => lerp,
+  lerpColor: () => lerpColor,
+  loader: () => loader,
+  padEnd: () => padEnd,
+  padStart: () => padStart,
+  rainbow: () => rainbow,
+  renderPixelArt: () => renderPixelArt,
+  repeatVisible: () => repeatVisible,
+  reset: () => reset,
+  resetNoColor: () => resetNoColor,
+  rgbTo256: () => rgbTo256,
+  rgbToHex: () => rgbToHex,
+  screen: () => screen,
+  setNoColor: () => setNoColor,
+  sgr: () => sgr,
+  sleep: () => sleep,
+  stripAnsi: () => stripAnsi,
+  supportsColor: () => supportsColor,
+  termSize: () => termSize,
+  themes: () => themes,
+  truncateAnsi: () => truncateAnsi,
+  visibleLen: () => visibleLen,
+  wordWrap: () => wordWrap,
+  write: () => write,
+  writeln: () => writeln
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/utils/ansi.ts
+var ESC = "\x1B";
+var CSI = `${ESC}[`;
+var cursor = {
+  up: (n = 1) => `${CSI}${n}A`,
+  down: (n = 1) => `${CSI}${n}B`,
+  right: (n = 1) => `${CSI}${n}C`,
+  left: (n = 1) => `${CSI}${n}D`,
+  to: (x, y) => `${CSI}${y};${x}H`,
+  save: () => `${CSI}s`,
+  restore: () => `${CSI}u`,
+  hide: () => `${CSI}?25l`,
+  show: () => `${CSI}?25h`
+};
+var screen = {
+  clear: () => `${CSI}2J${CSI}H`,
+  clearLine: () => `${CSI}2K`,
+  clearRight: () => `${CSI}0K`,
+  clearDown: () => `${CSI}0J`,
+  scrollUp: (n = 1) => `${CSI}${n}S`,
+  scrollDown: (n = 1) => `${CSI}${n}T`
+};
+var FG = {
+  black: 30,
+  red: 31,
+  green: 32,
+  yellow: 33,
+  blue: 34,
+  magenta: 35,
+  cyan: 36,
+  white: 37,
+  brightBlack: 90,
+  brightRed: 91,
+  brightGreen: 92,
+  brightYellow: 93,
+  brightBlue: 94,
+  brightMagenta: 95,
+  brightCyan: 96,
+  brightWhite: 97
+};
+var BG = {
+  black: 40,
+  red: 41,
+  green: 42,
+  yellow: 43,
+  blue: 44,
+  magenta: 45,
+  cyan: 46,
+  white: 47,
+  brightBlack: 100,
+  brightRed: 101,
+  brightGreen: 102,
+  brightYellow: 103,
+  brightBlue: 104,
+  brightMagenta: 105,
+  brightCyan: 106,
+  brightWhite: 107
+};
+var STYLE = {
+  reset: 0,
+  bold: 1,
+  dim: 2,
+  italic: 3,
+  underline: 4,
+  blink: 5,
+  inverse: 7,
+  hidden: 8,
+  strikethrough: 9
+};
+var sgr = (...codes) => `${CSI}${codes.join(";")}m`;
+var reset = () => sgr(STYLE.reset);
+var fgRgb = (r, g, b) => `${CSI}38;2;${r};${g};${b}m`;
+var bgRgb = (r, g, b) => `${CSI}48;2;${r};${g};${b}m`;
+var fg256 = (n) => `${CSI}38;5;${n}m`;
+var bg256 = (n) => `${CSI}48;5;${n}m`;
+var supportsColor = () => {
+  if (process.env["NO_COLOR"]) return "none";
+  if (process.env["COLORTERM"] === "truecolor" || process.env["COLORTERM"] === "24bit") return "truecolor";
+  if (process.env["TERM_PROGRAM"] === "iTerm.app") return "truecolor";
+  if (process.env["TERM"]?.includes("256color")) return "256";
+  return "basic";
+};
+var sleep = (ms) => new Promise((r) => setTimeout(() => r(), ms));
+var write = (str) => process.stdout.write(str);
+var writeln = (str = "") => process.stdout.write(str + "\n");
+
+// src/utils/helpers.ts
+var clamp = (n, min, max) => Math.min(Math.max(n, min), max);
+var lerp = (a, b, t) => a + (b - a) * t;
+var clampByte = (v) => clamp(Math.round(v), 0, 255);
+var HEX_RE = /^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
+var isHexColor = (hex) => typeof hex === "string" && HEX_RE.test(hex.trim());
+var hexToRgb = (hex) => {
+  if (!isHexColor(hex)) {
+    throw new Error(`Invalid hex color: "${hex}"`);
+  }
+  const clean = hex.trim().replace("#", "");
+  const full = clean.length === 3 ? clean.split("").map((c) => c + c).join("") : clean;
+  const int = parseInt(full, 16);
+  return { r: int >> 16 & 255, g: int >> 8 & 255, b: int & 255 };
+};
+var rgbToHex = (r, g, b) => "#" + [clampByte(r), clampByte(g), clampByte(b)].map((v) => v.toString(16).padStart(2, "0")).join("");
+var lerpColor = (a, b, t) => {
+  const ct = clamp(t, 0, 1);
+  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 rgbTo256 = (r, g, b) => {
+  const cr = clampByte(r), cg = clampByte(g), cb = clampByte(b);
+  if (cr === cg && cg === cb) {
+    if (cr < 8) return 16;
+    if (cr > 248) return 231;
+    return Math.round((cr - 8) / 247 * 24) + 232;
+  }
+  return 16 + 36 * Math.round(cr / 255 * 5) + 6 * Math.round(cg / 255 * 5) + Math.round(cb / 255 * 5);
+};
+var ANSI_RE = new RegExp(
+  [
+    "\\x1b\\[[0-9;?]*[a-zA-Z]",
+    // CSI
+    "\\x1b\\][^\\x07\\x1b]*(?:\\x07|\\x1b\\\\)",
+    // OSC
+    "\\x1b[NOMP78=>c]"
+    // single-char escapes
+  ].join("|"),
+  "g"
+);
+var stripAnsi = (str) => str.replace(ANSI_RE, "");
+var visibleLen = (str) => stripAnsi(str).length;
+var truncateAnsi = (str, width, ellipsis = "\u2026") => {
+  if (visibleLen(str) <= width) return str;
+  const ellipsisLen = visibleLen(ellipsis);
+  const target = Math.max(0, width - ellipsisLen);
+  let visible = 0;
+  let result = "";
+  let i = 0;
+  while (i < str.length && visible < target) {
+    if (str[i] === "\x1B") {
+      const match = str.slice(i).match(ANSI_RE);
+      if (match && match[0] && str.indexOf(match[0], i) === i) {
+        result += match[0];
+        i += match[0].length;
+        continue;
+      }
+    }
+    result += str[i];
+    visible++;
+    i++;
+  }
+  return result + ellipsis + "\x1B[0m";
+};
+var padEnd = (str, width, ch = " ") => {
+  const pad = width - visibleLen(str);
+  return pad > 0 ? str + ch.repeat(pad) : str;
+};
+var padStart = (str, width, ch = " ") => {
+  const pad = width - visibleLen(str);
+  return pad > 0 ? ch.repeat(pad) + str : str;
+};
+var center = (str, width, ch = " ") => {
+  const pad = width - visibleLen(str);
+  if (pad <= 0) return str;
+  const l = Math.floor(pad / 2);
+  const r = pad - l;
+  return ch.repeat(l) + str + ch.repeat(r);
+};
+var repeatVisible = (str, width) => {
+  if (!str || width <= 0) return "";
+  const unit = visibleLen(str);
+  if (unit === 0) return "";
+  const times = Math.ceil(width / unit);
+  return truncateAnsi(str.repeat(times), width, "");
+};
+var termSize = () => ({
+  cols: process.stdout.columns || 80,
+  rows: process.stdout.rows || 24
+});
+var wordWrap = (text, width) => {
+  if (width <= 0) return [text];
+  const words = text.split(" ");
+  const lines = [];
+  let current = "";
+  const breakLong = (word) => {
+    const chunks = [];
+    for (let i = 0; i < word.length; i += width) {
+      chunks.push(word.slice(i, i + width));
+    }
+    return chunks;
+  };
+  for (const raw of words) {
+    const tokens = raw.length > width ? breakLong(raw) : [raw];
+    for (const word of tokens) {
+      if (current.length + word.length + (current ? 1 : 0) <= width) {
+        current += (current ? " " : "") + word;
+      } else {
+        if (current) lines.push(current);
+        current = word;
+      }
+    }
+  }
+  if (current) lines.push(current);
+  return lines;
+};
+
+// src/colors/index.ts
+var _noColor = null;
+var setNoColor = (v) => {
+  _noColor = v;
+};
+var resetNoColor = () => {
+  _noColor = null;
+};
+var isNoColor = () => {
+  if (_noColor !== null) return _noColor;
+  return Boolean(process.env["NO_COLOR"]) || !process.stdout.isTTY;
+};
+var clampRgb = (n) => Math.max(0, Math.min(255, Math.round(n)));
+var clamp256 = (n) => Math.max(0, Math.min(255, Math.round(n)));
+var HEX_RE2 = /^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
+var safeHex = (h) => {
+  if (!HEX_RE2.test(h.trim())) return null;
+  return hexToRgb(h);
+};
+var wrap = (open, text) => isNoColor() ? text : `${open}${text}${reset()}`;
+var makeFg = (code) => (text) => wrap(sgr(code), text);
+var makeBg = (code) => (text) => wrap(sgr(code), text);
+var compose = (...fns) => (text) => {
+  if (isNoColor()) return text;
+  const opens = fns.map((fn) => {
+    const result = fn("");
+    return result.endsWith(reset()) ? result.slice(0, -reset().length) : result;
+  });
+  return opens.join("") + text + reset();
+};
+var gradient = (text, stops) => {
+  if (!text || isNoColor()) return text;
+  const colors = stops.map(safeHex).filter((c) => c !== null);
+  if (colors.length < 2) return text;
+  const chars = [...text];
+  const visible = chars.filter((c) => c !== " ").length;
+  if (visible === 0) return text;
+  let colorIdx = 0;
+  return chars.map((ch) => {
+    if (ch === " ") return ch;
+    const t = visible === 1 ? 0 : colorIdx / (visible - 1);
+    const scaled = t * (colors.length - 1);
+    const lo = Math.floor(scaled);
+    const hi = Math.min(lo + 1, colors.length - 1);
+    const { r, g, b } = lerpColor(colors[lo], colors[hi], scaled - lo);
+    colorIdx++;
+    return fgRgb(r, g, b) + ch + reset();
+  }).join("");
+};
+var RAINBOW = ["#ff0000", "#ff7f00", "#ffff00", "#00ff00", "#0000ff", "#8b00ff"];
+var rainbow = (text) => gradient(text, RAINBOW);
+var presets = {
+  sunset: (t) => gradient(t, ["#ff6b6b", "#feca57", "#48dbfb"]),
+  ocean: (t) => gradient(t, ["#0575e6", "#021b79"]),
+  fire: (t) => gradient(t, ["#f7971e", "#ffd200", "#ff0000"]),
+  neon: (t) => gradient(t, ["#f953c6", "#b91d73"]),
+  forest: (t) => gradient(t, ["#134e5e", "#71b280"]),
+  aurora: (t) => gradient(t, ["#00c6ff", "#0072ff", "#7e57c2"]),
+  candy: (t) => gradient(t, ["#fd79a8", "#a29bfe", "#74b9ff"]),
+  gold: (t) => gradient(t, ["#f7971e", "#ffd200"])
+};
+var color = {
+  // ── Named foreground colors ──
+  black: makeFg(FG.black),
+  red: makeFg(FG.red),
+  green: makeFg(FG.green),
+  yellow: makeFg(FG.yellow),
+  blue: makeFg(FG.blue),
+  magenta: makeFg(FG.magenta),
+  cyan: makeFg(FG.cyan),
+  white: makeFg(FG.white),
+  // ── Bright foreground ──
+  brightBlack: makeFg(FG.brightBlack),
+  brightRed: makeFg(FG.brightRed),
+  brightGreen: makeFg(FG.brightGreen),
+  brightYellow: makeFg(FG.brightYellow),
+  brightBlue: makeFg(FG.brightBlue),
+  brightMagenta: makeFg(FG.brightMagenta),
+  brightCyan: makeFg(FG.brightCyan),
+  brightWhite: makeFg(FG.brightWhite),
+  // ── Common aliases ──
+  gray: makeFg(FG.brightBlack),
+  grey: makeFg(FG.brightBlack),
+  orange: (t) => wrap(fgRgb(255, 165, 0), t),
+  purple: makeFg(FG.magenta),
+  // ── Named background colors ──
+  bgBlack: makeBg(BG.black),
+  bgRed: makeBg(BG.red),
+  bgGreen: makeBg(BG.green),
+  bgYellow: makeBg(BG.yellow),
+  bgBlue: makeBg(BG.blue),
+  bgMagenta: makeBg(BG.magenta),
+  bgCyan: makeBg(BG.cyan),
+  bgWhite: makeBg(BG.white),
+  // ── Text styles ──
+  bold: (t) => wrap(sgr(STYLE.bold), t),
+  dim: (t) => wrap(sgr(STYLE.dim), t),
+  italic: (t) => wrap(sgr(STYLE.italic), t),
+  underline: (t) => wrap(sgr(STYLE.underline), t),
+  blink: (t) => wrap(sgr(STYLE.blink), t),
+  // terminal support varies
+  inverse: (t) => wrap(sgr(STYLE.inverse), t),
+  strikethrough: (t) => wrap(sgr(STYLE.strikethrough), t),
+  hidden: (t) => wrap(sgr(STYLE.hidden), t),
+  // ── True-color (24-bit) — values clamped to 0–255 ──
+  rgb: (r, g, b) => (t) => wrap(fgRgb(clampRgb(r), clampRgb(g), clampRgb(b)), t),
+  bgRgb: (r, g, b) => (t) => wrap(bgRgb(clampRgb(r), clampRgb(g), clampRgb(b)), t),
+  // ── Hex — fail-soft: invalid hex → plain text ──
+  hex: (h) => (t) => {
+    const p = safeHex(h);
+    return p ? wrap(fgRgb(p.r, p.g, p.b), t) : t;
+  },
+  bgHex: (h) => (t) => {
+    const p = safeHex(h);
+    return p ? wrap(bgRgb(p.r, p.g, p.b), t) : t;
+  },
+  // ── 256-color — value clamped to 0–255 ──
+  color256: (n) => (t) => wrap(fg256(clamp256(n)), t),
+  bgColor256: (n) => (t) => wrap(bg256(clamp256(n)), t),
+  // ── Gradients ──
+  gradient,
+  rainbow,
+  ...presets
+};
+
+// src/animations/index.ts
+var isTTY = () => Boolean(process.stdout.isTTY);
+var resolveRgb = (c) => typeof c === "string" ? hexToRgb(c) : c;
+var safeSteps = (n) => Math.max(1, n);
+var typewriter = async (text, opts = {}) => {
+  const { speed = 50, newline = true, colorFn = null, signal, reducedMotion = false } = opts;
+  if (!isTTY() || reducedMotion) {
+    write(colorFn ? [...text].map(colorFn).join("") : text);
+    if (newline) writeln();
+    return;
+  }
+  write(cursor.hide());
+  try {
+    for (const ch of text) {
+      if (signal?.aborted) break;
+      write(colorFn ? colorFn(ch) : ch);
+      if (ch !== " ") await sleep(speed);
+    }
+  } finally {
+    write(cursor.show());
+    if (newline) writeln();
+  }
+};
+var fadeIn = async (text, opts = {}) => {
+  const {
+    duration = 800,
+    steps = 16,
+    newline = true,
+    color: baseColor = { r: 255, g: 255, b: 255 },
+    signal,
+    reducedMotion = false
+  } = opts;
+  if (!isTTY() || reducedMotion) {
+    write(text);
+    if (newline) writeln();
+    return;
+  }
+  const base = resolveRgb(baseColor);
+  const n = safeSteps(steps);
+  write(cursor.hide());
+  try {
+    for (let i = 0; i <= n; i++) {
+      if (signal?.aborted) break;
+      const t = i / n;
+      write(
+        cursor.save() + fgRgb(Math.round(base.r * t), Math.round(base.g * t), Math.round(base.b * t)) + text + reset() + cursor.restore()
+      );
+      await sleep(duration / n);
+    }
+  } finally {
+    write(cursor.show());
+    if (newline) writeln();
+  }
+};
+var fadeOut = async (text, opts = {}) => {
+  const {
+    duration = 800,
+    steps = 16,
+    newline = true,
+    color: baseColor = { r: 255, g: 255, b: 255 },
+    signal,
+    reducedMotion = false
+  } = opts;
+  if (!isTTY() || reducedMotion) {
+    if (newline) writeln();
+    return;
+  }
+  const base = resolveRgb(baseColor);
+  const n = safeSteps(steps);
+  write(cursor.hide());
+  try {
+    for (let i = n; i >= 0; i--) {
+      if (signal?.aborted) break;
+      const t = i / n;
+      write(
+        cursor.save() + fgRgb(Math.round(base.r * t), Math.round(base.g * t), Math.round(base.b * t)) + text + reset() + cursor.restore()
+      );
+      await sleep(duration / n);
+    }
+  } finally {
+    write(cursor.show());
+    if (newline) writeln();
+  }
+};
+var slide = async (text, opts = {}) => {
+  const { direction = "left", duration = 400, newline = true, signal, reducedMotion = false } = opts;
+  if (!isTTY() || reducedMotion) {
+    write(text);
+    if (newline) writeln();
+    return;
+  }
+  const len = text.length;
+  const steps = Math.min(Math.max(1, len), 40);
+  const delay = duration / steps;
+  write(cursor.hide());
+  try {
+    for (let i = 1; i <= steps; i++) {
+      if (signal?.aborted) break;
+      const shown = Math.floor(i / steps * len);
+      const line = direction === "right" ? " ".repeat(len - shown) + text.slice(0, shown) : text.slice(0, shown);
+      write(cursor.save() + screen.clearRight() + line + cursor.restore());
+      await sleep(delay);
+    }
+    write(cursor.save() + screen.clearRight() + text + cursor.restore());
+  } finally {
+    write(cursor.show());
+    if (newline) writeln();
+  }
+};
+var pulse = async (text, opts = {}) => {
+  const {
+    times = 3,
+    interval = 300,
+    color1 = { r: 255, g: 255, b: 255 },
+    color2 = { r: 100, g: 100, b: 100 },
+    newline = true,
+    signal,
+    reducedMotion = false
+  } = opts;
+  if (!isTTY() || reducedMotion) {
+    write(text);
+    if (newline) writeln();
+    return;
+  }
+  const c1 = resolveRgb(color1);
+  const c2 = resolveRgb(color2);
+  write(cursor.hide());
+  try {
+    for (let t = 0; t < times; t++) {
+      if (signal?.aborted) break;
+      write(cursor.save() + fgRgb(c1.r, c1.g, c1.b) + text + reset() + cursor.restore());
+      await sleep(interval);
+      if (signal?.aborted) break;
+      write(cursor.save() + fgRgb(c2.r, c2.g, c2.b) + text + reset() + cursor.restore());
+      await sleep(interval);
+    }
+    write(cursor.save() + fgRgb(c1.r, c1.g, c1.b) + text + reset() + cursor.restore());
+  } finally {
+    write(cursor.show());
+    if (newline) writeln();
+  }
+};
+var wave = async (text, opts = {}) => {
+  const {
+    duration = 2e3,
+    steps = 30,
+    colors = ["#ff0000", "#ff7f00", "#ffff00", "#00ff00", "#0000ff", "#8b00ff"],
+    newline = true,
+    signal,
+    reducedMotion = false
+  } = opts;
+  if (!isTTY() || reducedMotion) {
+    write(text);
+    if (newline) writeln();
+    return;
+  }
+  if (!text.length) {
+    if (newline) writeln();
+    return;
+  }
+  const palette = colors.map(hexToRgb);
+  const n = safeSteps(steps);
+  const delay = duration / n;
+  const chars = [...text];
+  const len = chars.length;
+  write(cursor.hide());
+  try {
+    for (let frame = 0; frame < n; frame++) {
+      if (signal?.aborted) break;
+      const offset = frame / n;
+      const colored = chars.map((ch, i) => {
+        if (ch === " ") return ch;
+        const t = (i / len + offset) % 1;
+        const scaled = t * (palette.length - 1);
+        const lo = Math.floor(scaled);
+        const hi = Math.min(lo + 1, palette.length - 1);
+        const { r, g, b } = lerpColor(palette[lo], palette[hi], scaled - lo);
+        return fgRgb(r, g, b) + ch + reset();
+      }).join("");
+      write(cursor.save() + screen.clearRight() + colored + cursor.restore());
+      await sleep(delay);
+    }
+  } finally {
+    write(cursor.show());
+    if (newline) writeln();
+  }
+};
+var glitch = async (text, opts = {}) => {
+  const { duration = 800, intensity = 3, newline = true, signal, reducedMotion = false } = opts;
+  if (!isTTY() || reducedMotion) {
+    write(text);
+    if (newline) writeln();
+    return;
+  }
+  const glitchChars = "!@#$%^&*[]{}|<>/\\~`\xB1\xA7";
+  const end = Date.now() + duration;
+  write(cursor.hide());
+  try {
+    while (Date.now() < end) {
+      if (signal?.aborted) break;
+      const out = [...text].map((ch) => {
+        if (ch === " ") return ch;
+        return Math.random() < intensity / 10 ? glitchChars[Math.floor(Math.random() * glitchChars.length)] : ch;
+      }).join("");
+      write(cursor.save() + screen.clearRight() + out + cursor.restore());
+      await sleep(40);
+    }
+    write(cursor.save() + screen.clearRight() + text + cursor.restore());
+  } finally {
+    write(cursor.show());
+    if (newline) writeln();
+  }
+};
+var reveal = async (text, opts = {}) => {
+  const {
+    duration = 1e3,
+    charset = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789",
+    newline = true,
+    signal,
+    reducedMotion = false
+  } = opts;
+  if (!isTTY() || reducedMotion) {
+    write(text);
+    if (newline) writeln();
+    return;
+  }
+  const len = text.length;
+  const n = safeSteps(20);
+  const delay = duration / n;
+  const solved = new Array(len).fill(false);
+  write(cursor.hide());
+  try {
+    for (let step = 0; step < n; step++) {
+      if (signal?.aborted) break;
+      const toSolve = Math.floor(step / n * len);
+      for (let i = 0; i < toSolve; i++) solved[i] = true;
+      const line = [...text].map((ch, i) => {
+        if (ch === " ") return " ";
+        if (solved[i]) return ch;
+        return charset[Math.floor(Math.random() * charset.length)];
+      }).join("");
+      write(cursor.save() + screen.clearRight() + line + cursor.restore());
+      await sleep(delay);
+    }
+    write(cursor.save() + screen.clearRight() + text + cursor.restore());
+  } finally {
+    write(cursor.show());
+    if (newline) writeln();
+  }
+};
+var animate = {
+  typewriter,
+  fadeIn,
+  fadeOut,
+  slide,
+  pulse,
+  wave,
+  glitch,
+  reveal
+};
+
+// src/ascii/index.ts
+var BLOCK = {
+  " ": ["     ", "     ", "     ", "     ", "     "],
+  A: [" \u2588\u2588\u2588 ", "\u2588   \u2588", "\u2588\u2588\u2588\u2588\u2588", "\u2588   \u2588", "\u2588   \u2588"],
+  B: ["\u2588\u2588\u2588\u2588 ", "\u2588   \u2588", "\u2588\u2588\u2588\u2588 ", "\u2588   \u2588", "\u2588\u2588\u2588\u2588 "],
+  C: [" \u2588\u2588\u2588 ", "\u2588    ", "\u2588    ", "\u2588    ", " \u2588\u2588\u2588 "],
+  D: ["\u2588\u2588\u2588\u2588 ", "\u2588   \u2588", "\u2588   \u2588", "\u2588   \u2588", "\u2588\u2588\u2588\u2588 "],
+  E: ["\u2588\u2588\u2588\u2588\u2588", "\u2588    ", "\u2588\u2588\u2588\u2588 ", "\u2588    ", "\u2588\u2588\u2588\u2588\u2588"],
+  F: ["\u2588\u2588\u2588\u2588\u2588", "\u2588    ", "\u2588\u2588\u2588\u2588 ", "\u2588    ", "\u2588    "],
+  G: [" \u2588\u2588\u2588\u2588", "\u2588    ", "\u2588  \u2588\u2588", "\u2588   \u2588", " \u2588\u2588\u2588\u2588"],
+  H: ["\u2588   \u2588", "\u2588   \u2588", "\u2588\u2588\u2588\u2588\u2588", "\u2588   \u2588", "\u2588   \u2588"],
+  I: ["\u2588\u2588\u2588\u2588\u2588", "  \u2588  ", "  \u2588  ", "  \u2588  ", "\u2588\u2588\u2588\u2588\u2588"],
+  J: ["\u2588\u2588\u2588\u2588\u2588", "   \u2588 ", "   \u2588 ", "\u2588  \u2588 ", " \u2588\u2588  "],
+  K: ["\u2588   \u2588", "\u2588  \u2588 ", "\u2588\u2588\u2588  ", "\u2588  \u2588 ", "\u2588   \u2588"],
+  L: ["\u2588    ", "\u2588    ", "\u2588    ", "\u2588    ", "\u2588\u2588\u2588\u2588\u2588"],
+  M: ["\u2588   \u2588", "\u2588\u2588 \u2588\u2588", "\u2588 \u2588 \u2588", "\u2588   \u2588", "\u2588   \u2588"],
+  N: ["\u2588   \u2588", "\u2588\u2588  \u2588", "\u2588 \u2588 \u2588", "\u2588  \u2588\u2588", "\u2588   \u2588"],
+  O: [" \u2588\u2588\u2588 ", "\u2588   \u2588", "\u2588   \u2588", "\u2588   \u2588", " \u2588\u2588\u2588 "],
+  P: ["\u2588\u2588\u2588\u2588 ", "\u2588   \u2588", "\u2588\u2588\u2588\u2588 ", "\u2588    ", "\u2588    "],
+  Q: [" \u2588\u2588\u2588 ", "\u2588   \u2588", "\u2588 \u2588 \u2588", "\u2588  \u2588\u2588", " \u2588\u2588\u2588\u2588"],
+  R: ["\u2588\u2588\u2588\u2588 ", "\u2588   \u2588", "\u2588\u2588\u2588\u2588 ", "\u2588  \u2588 ", "\u2588   \u2588"],
+  S: [" \u2588\u2588\u2588\u2588", "\u2588    ", " \u2588\u2588\u2588 ", "    \u2588", "\u2588\u2588\u2588\u2588 "],
+  T: ["\u2588\u2588\u2588\u2588\u2588", "  \u2588  ", "  \u2588  ", "  \u2588  ", "  \u2588  "],
+  U: ["\u2588   \u2588", "\u2588   \u2588", "\u2588   \u2588", "\u2588   \u2588", " \u2588\u2588\u2588 "],
+  V: ["\u2588   \u2588", "\u2588   \u2588", "\u2588   \u2588", " \u2588 \u2588 ", "  \u2588  "],
+  W: ["\u2588   \u2588", "\u2588   \u2588", "\u2588 \u2588 \u2588", "\u2588\u2588 \u2588\u2588", "\u2588   \u2588"],
+  X: ["\u2588   \u2588", " \u2588 \u2588 ", "  \u2588  ", " \u2588 \u2588 ", "\u2588   \u2588"],
+  Y: ["\u2588   \u2588", " \u2588 \u2588 ", "  \u2588  ", "  \u2588  ", "  \u2588  "],
+  Z: ["\u2588\u2588\u2588\u2588\u2588", "   \u2588 ", "  \u2588  ", " \u2588   ", "\u2588\u2588\u2588\u2588\u2588"],
+  "0": [" \u2588\u2588\u2588 ", "\u2588  \u2588\u2588", "\u2588 \u2588 \u2588", "\u2588\u2588  \u2588", " \u2588\u2588\u2588 "],
+  "1": ["  \u2588  ", " \u2588\u2588  ", "  \u2588  ", "  \u2588  ", "\u2588\u2588\u2588\u2588\u2588"],
+  "2": [" \u2588\u2588\u2588 ", "\u2588   \u2588", "  \u2588\u2588 ", " \u2588   ", "\u2588\u2588\u2588\u2588\u2588"],
+  "3": ["\u2588\u2588\u2588\u2588 ", "    \u2588", " \u2588\u2588\u2588 ", "    \u2588", "\u2588\u2588\u2588\u2588 "],
+  "4": ["\u2588   \u2588", "\u2588   \u2588", "\u2588\u2588\u2588\u2588\u2588", "    \u2588", "    \u2588"],
+  "5": ["\u2588\u2588\u2588\u2588\u2588", "\u2588    ", "\u2588\u2588\u2588\u2588 ", "    \u2588", "\u2588\u2588\u2588\u2588 "],
+  "6": [" \u2588\u2588\u2588 ", "\u2588    ", "\u2588\u2588\u2588\u2588 ", "\u2588   \u2588", " \u2588\u2588\u2588 "],
+  "7": ["\u2588\u2588\u2588\u2588\u2588", "   \u2588 ", "  \u2588  ", " \u2588   ", "\u2588    "],
+  "8": [" \u2588\u2588\u2588 ", "\u2588   \u2588", " \u2588\u2588\u2588 ", "\u2588   \u2588", " \u2588\u2588\u2588 "],
+  "9": [" \u2588\u2588\u2588 ", "\u2588   \u2588", " \u2588\u2588\u2588\u2588", "    \u2588", " \u2588\u2588\u2588 "],
+  "!": ["  \u2588  ", "  \u2588  ", "  \u2588  ", "     ", "  \u2588  "],
+  "?": [" \u2588\u2588\u2588 ", "\u2588   \u2588", "   \u2588 ", "     ", "  \u2588  "],
+  ".": ["     ", "     ", "     ", "     ", "  \u2588  "],
+  "-": ["     ", "     ", "\u2588\u2588\u2588\u2588 ", "     ", "     "],
+  "+": ["     ", "  \u2588  ", "\u2588\u2588\u2588\u2588\u2588", "  \u2588  ", "     "],
+  "#": [" \u2588 \u2588 ", "\u2588\u2588\u2588\u2588\u2588", " \u2588 \u2588 ", "\u2588\u2588\u2588\u2588\u2588", " \u2588 \u2588 "],
+  "@": [" \u2588\u2588\u2588 ", "\u2588   \u2588", "\u2588 \u2588\u2588 ", "\u2588    ", " \u2588\u2588\u2588\u2588"]
+};
+var SMALL = {
+  " ": ["   ", "   ", "   "],
+  A: ["\u2584\u2580\u2584", "\u2588\u2580\u2588", "\u2580 \u2580"],
+  B: ["\u2588\u2580\u2584", "\u2588\u2580\u2584", "\u2580\u2580 "],
+  C: ["\u2584\u2580\u2580", "\u2588  ", "\u2580\u2580\u2584"],
+  D: ["\u2588\u2580\u2584", "\u2588 \u2588", "\u2580\u2580 "],
+  E: ["\u2588\u2580\u2580", "\u2588\u2580 ", "\u2580\u2580\u2580"],
+  F: ["\u2588\u2580\u2580", "\u2588\u2580 ", "\u2580  "],
+  G: ["\u2584\u2580\u2580", "\u2588 \u2584", "\u2580\u2580\u2598"],
+  H: ["\u2588 \u2588", "\u2588\u2588\u2588", "\u2580 \u2580"],
+  I: ["\u2580\u2588\u2580", " \u2588 ", "\u2580\u2588\u2580"],
+  J: [" \u2584\u2588", "  \u2588", "\u2580\u2580 "],
+  K: ["\u2588\u2584\u2580", "\u2588\u2580\u2584", "\u2580 \u2580"],
+  L: ["\u2588  ", "\u2588  ", "\u2580\u2580\u2580"],
+  M: ["\u2588\u2584\u2588", "\u2588 \u2588", "\u2580 \u2580"],
+  N: ["\u2588\u2584\u2588", "\u2588\u2580\u2588", "\u2580 \u2580"],
+  O: ["\u2584\u2580\u2584", "\u2588 \u2588", "\u2580\u2584\u2580"],
+  P: ["\u2588\u2580\u2584", "\u2588\u2588 ", "\u2580  "],
+  Q: ["\u2584\u2580\u2584", "\u2588\u2584\u2588", "\u2580\u2584\u2580"],
+  R: ["\u2588\u2580\u2584", "\u2588\u2588\u2584", "\u2580 \u2580"],
+  S: ["\u2584\u2580\u2580", "\u2580\u2580\u2584", "\u2584\u2584\u2598"],
+  T: ["\u2580\u2588\u2580", " \u2588 ", " \u2580 "],
+  U: ["\u2588 \u2588", "\u2588 \u2588", "\u2580\u2584\u2580"],
+  V: ["\u2588 \u2588", "\u2588 \u2588", " \u2580 "],
+  W: ["\u2588 \u2588", "\u2588\u2584\u2588", "\u2580 \u2580"],
+  X: ["\u2580\u2584\u2580", " \u2588 ", "\u2580 \u2580"],
+  Y: ["\u2580\u2584\u2580", " \u2588 ", " \u2580 "],
+  Z: ["\u2580\u2580\u2588", " \u2588 ", "\u2588\u2580\u2580"],
+  "0": ["\u2584\u2580\u2584", "\u2588 \u2588", "\u2580\u2584\u2580"],
+  "1": [" \u2588 ", " \u2588 ", " \u2588 "],
+  "2": ["\u2584\u2580\u2584", " \u2584\u2580", "\u2580\u2580\u2580"],
+  "3": ["\u2580\u2580\u2584", " \u2580\u2584", "\u2584\u2584\u2598"],
+  "4": ["\u2588\u2584\u2588", "  \u2588", "  \u2580"],
+  "5": ["\u2588\u2580\u2580", "\u2580\u2580\u2584", "\u2584\u2584\u2598"],
+  "6": ["\u2584\u2580 ", "\u2588\u2580\u2584", "\u2580\u2584\u2580"],
+  "7": ["\u2580\u2580\u2588", "  \u2588", "  \u2580"],
+  "8": ["\u2584\u2580\u2584", "\u2584\u2580\u2584", "\u2580\u2584\u2580"],
+  "9": ["\u2584\u2580\u2584", "\u2580\u2580\u2588", " \u2584\u2598"],
+  "!": [" \u2588 ", " \u2588 ", " \u25AA "],
+  "?": ["\u2584\u2580\u2584", " \u2584\u2598", " \u25AA "],
+  ".": ["   ", "   ", " \u25AA "],
+  "-": ["   ", "\u2500\u2500\u2500", "   "],
+  ":": [" \u25AA ", "   ", " \u25AA "]
+};
+var renderFont = (text, fontMap) => {
+  if (!text.length) return "";
+  const sampleChar = fontMap[" "];
+  const charWidth = sampleChar[0].length;
+  const empty = " ".repeat(charWidth);
+  const chars = text.toUpperCase().split("").map((c) => fontMap[c] ?? fontMap["?"] ?? [empty]);
+  const height = chars[0].length;
+  const lines = [];
+  for (let row = 0; row < height; row++) {
+    lines.push(chars.map((c) => c[row] ?? empty).join(" "));
+  }
+  return lines.join("\n");
+};
+var BOX_STYLES = {
+  single: { tl: "\u250C", tr: "\u2510", bl: "\u2514", br: "\u2518", h: "\u2500", v: "\u2502" },
+  double: { tl: "\u2554", tr: "\u2557", bl: "\u255A", br: "\u255D", h: "\u2550", v: "\u2551" },
+  rounded: { tl: "\u256D", tr: "\u256E", bl: "\u2570", br: "\u256F", h: "\u2500", v: "\u2502" },
+  heavy: { tl: "\u250F", tr: "\u2513", bl: "\u2517", br: "\u251B", h: "\u2501", v: "\u2503" },
+  dashed: { tl: "\u250C", tr: "\u2510", bl: "\u2514", br: "\u2518", h: "\u254C", v: "\u254E" },
+  ascii: { tl: "+", tr: "+", bl: "+", br: "+", h: "-", v: "|" }
+};
+var big = (text) => renderFont(text, BLOCK);
+var small = (text) => renderFont(text, SMALL);
+var figlet = (text, opts = {}) => opts.font === "small" ? small(text) : big(text);
+var banner = (text, opts = {}) => {
+  const { font = "big", colorFn = null, align = "left" } = opts;
+  let rendered = font === "small" ? small(text) : big(text);
+  if (align === "center") {
+    const { cols } = termSize();
+    rendered = rendered.split("\n").map((l) => center(l, cols)).join("\n");
+  }
+  if (colorFn) rendered = rendered.split("\n").map(colorFn).join("\n");
+  return rendered;
+};
+var box = (text, opts = {}) => {
+  const { padding = 1, borderStyle = "rounded", width = null } = opts;
+  const b = BOX_STYLES[borderStyle] ?? BOX_STYLES.rounded;
+  const lines = text.split("\n");
+  const inner = width != null ? lines.map((l) => padEnd(truncateAnsi(l, width, ""), width)) : lines;
+  const w = Math.max(...inner.map((l) => visibleLen(l)), 0);
+  const pad = " ".repeat(padding);
+  const top = b.tl + b.h.repeat(w + padding * 2) + b.tr;
+  const bottom = b.bl + b.h.repeat(w + padding * 2) + b.br;
+  const emptyRow = b.v + " ".repeat(w + padding * 2) + b.v;
+  const rows = inner.map((l) => b.v + pad + padEnd(l, w) + pad + b.v);
+  const vPad = Array(padding).fill(emptyRow);
+  return [top, ...vPad, ...rows, ...vPad, bottom].join("\n");
+};
+var divider = (opts = {}) => {
+  const { char, width = null, label = null, style = "single" } = opts;
+  const { cols } = termSize();
+  const w = width ?? cols;
+  const b = BOX_STYLES[style] ?? BOX_STYLES.single;
+  const fill = char ?? b.h;
+  if (label) {
+    const labelLen = visibleLen(label);
+    const side = Math.max(0, Math.floor((w - labelLen - 2) / 2));
+    const trailLen = Math.max(0, w - side - labelLen - 2);
+    return fill.repeat(side) + " " + label + " " + fill.repeat(trailLen);
+  }
+  return fill.repeat(Math.max(0, w));
+};
+var logo = (text, opts = {}) => {
+  const { gradient: gfn = null, boxStyle = "double" } = opts;
+  const art = big(text);
+  const lines = art.split("\n").map((l) => gfn ? gfn(l) : l);
+  return box(lines.join("\n"), { borderStyle: boxStyle, padding: 1 });
+};
+var ascii = {
+  big,
+  small,
+  figlet,
+  banner,
+  box,
+  divider,
+  logo,
+  boxStyles: Object.keys(BOX_STYLES)
+};
+
+// src/loaders/index.ts
+var isTTY2 = () => Boolean(process.stdout.isTTY);
+var HEX_RE3 = /^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
+var safeColor = (hex) => {
+  if (!hex || !HEX_RE3.test(hex.trim())) return null;
+  return hexToRgb(hex);
+};
+var SPINNERS = {
+  dots: ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"],
+  dots2: ["\u28FE", "\u28FD", "\u28FB", "\u28BF", "\u287F", "\u28DF", "\u28EF", "\u28F7"],
+  line: ["-", "\\", "|", "/"],
+  arrow: ["\u2190", "\u2196", "\u2191", "\u2197", "\u2192", "\u2198", "\u2193", "\u2199"],
+  bounce: ["\u2801", "\u2802", "\u2804", "\u2802"],
+  star: ["\u2736", "\u2738", "\u2739", "\u273A", "\u2739", "\u2737"],
+  moon: ["\u{1F311}", "\u{1F312}", "\u{1F313}", "\u{1F314}", "\u{1F315}", "\u{1F316}", "\u{1F317}", "\u{1F318}"],
+  clock: ["\u{1F55B}", "\u{1F550}", "\u{1F551}", "\u{1F552}", "\u{1F553}", "\u{1F554}", "\u{1F555}", "\u{1F556}", "\u{1F557}", "\u{1F558}", "\u{1F559}", "\u{1F55A}"],
+  pong: [
+    "\u2590\u2802       \u258C",
+    "\u2590\u2808       \u258C",
+    "\u2590 \u2802      \u258C",
+    "\u2590 \u2820      \u258C",
+    "\u2590  \u2840     \u258C",
+    "\u2590  \u2820     \u258C",
+    "\u2590   \u2802    \u258C",
+    "\u2590   \u2808    \u258C",
+    "\u2590    \u2802   \u258C",
+    "\u2590    \u2820   \u258C",
+    "\u2590     \u2840  \u258C",
+    "\u2590     \u2820  \u258C",
+    "\u2590      \u2802 \u258C",
+    "\u2590      \u2808 \u258C",
+    "\u2590       \u2802\u258C",
+    "\u2590       \u2820\u258C",
+    "\u2590       \u2840\u258C",
+    "\u2590      \u2820 \u258C",
+    "\u2590      \u2802 \u258C",
+    "\u2590     \u2808  \u258C"
+  ],
+  aesthetic: ["\u25B0\u25B1\u25B1\u25B1\u25B1\u25B1\u25B1", "\u25B0\u25B0\u25B1\u25B1\u25B1\u25B1\u25B1", "\u25B0\u25B0\u25B0\u25B1\u25B1\u25B1\u25B1", "\u25B0\u25B0\u25B0\u25B0\u25B1\u25B1\u25B1", "\u25B0\u25B0\u25B0\u25B0\u25B0\u25B1\u25B1", "\u25B0\u25B0\u25B0\u25B0\u25B0\u25B0\u25B1", "\u25B0\u25B0\u25B0\u25B0\u25B0\u25B0\u25B0"],
+  blocks: ["\u2588\u2592\u2592\u2592\u2592\u2592\u2592", "\u2588\u2588\u2592\u2592\u2592\u2592\u2592", "\u2588\u2588\u2588\u2592\u2592\u2592\u2592", "\u2588\u2588\u2588\u2588\u2592\u2592\u2592", "\u2588\u2588\u2588\u2588\u2588\u2592\u2592", "\u2588\u2588\u2588\u2588\u2588\u2588\u2592", "\u2588\u2588\u2588\u2588\u2588\u2588\u2588"]
+};
+var spin = (text = "Loading...", opts = {}) => {
+  const {
+    type = "dots",
+    interval = 80,
+    color: colorStr = null,
+    prefix = "",
+    suffix = "",
+    persist = false,
+    signal,
+    reducedMotion = false
+  } = opts;
+  if (!isTTY2() || reducedMotion) {
+    write(text + "\n");
+    return (message, success = true) => {
+      if (!message) return;
+      const icon = success ? "\u2713" : "\u2717";
+      const clr = success ? `${sgr(FG.green)}${icon}${reset()}` : `${sgr(FG.red)}${icon}${reset()}`;
+      writeln(`${clr} ${message}`);
+    };
+  }
+  const frames2 = SPINNERS[type] ?? SPINNERS.dots;
+  const rgb = safeColor(colorStr);
+  let i = 0;
+  let stopped = false;
+  let timer;
+  write(cursor.hide());
+  const stop = (message, success = true) => {
+    if (stopped) return;
+    stopped = true;
+    clearInterval(timer);
+    if (abortHandler) signal?.removeEventListener("abort", abortHandler);
+    write(cursor.show() + screen.clearLine() + "\r");
+    if (message) {
+      const icon = success ? "\u2713" : "\u2717";
+      const clr = success ? `${sgr(FG.green)}${icon}${reset()}` : `${sgr(FG.red)}${icon}${reset()}`;
+      writeln(`${clr} ${message}`);
+    } else if (persist) {
+      writeln(`  ${text}`);
+    }
+  };
+  const abortHandler = signal ? () => stop("Cancelled", false) : null;
+  if (abortHandler) signal?.addEventListener("abort", abortHandler, { once: true });
+  timer = setInterval(() => {
+    if (stopped) return;
+    if (signal?.aborted) {
+      stop();
+      return;
+    }
+    const frame = frames2[i % frames2.length];
+    const colored = rgb ? fgRgb(rgb.r, rgb.g, rgb.b) + frame + reset() : frame;
+    write(cursor.save() + screen.clearLine() + `\r${prefix}${colored} ${text}${suffix}` + cursor.restore());
+    i++;
+  }, interval);
+  return stop;
+};
+var dots = (text = "Processing", opts = {}) => {
+  const { interval = 400, max = 3, signal } = opts;
+  if (!isTTY2()) {
+    write(text + "\n");
+    return () => {
+    };
+  }
+  let i = 0;
+  let stopped = false;
+  write(cursor.hide());
+  const stop = () => {
+    if (stopped) return;
+    stopped = true;
+    clearInterval(timer);
+    write(cursor.show() + screen.clearLine() + "\r");
+  };
+  if (signal) signal.addEventListener("abort", stop, { once: true });
+  const timer = setInterval(() => {
+    if (stopped) return;
+    const d = ".".repeat(i % max + 1).padEnd(max);
+    write(cursor.save() + screen.clearLine() + `\r${text}${d}` + cursor.restore());
+    i++;
+  }, interval);
+  return stop;
+};
+var progress = (percent, label = "", opts = {}) => {
+  const {
+    width = 30,
+    char = "\u2588",
+    emptyChar = "\u2591",
+    showPercentage = true,
+    color: colorStr = null
+  } = opts;
+  const safeWidth = Math.max(1, width);
+  const clamped = Math.min(100, Math.max(0, percent));
+  const filled = Math.round(clamped / 100 * safeWidth);
+  const empty = safeWidth - filled;
+  const rgb = safeColor(colorStr);
+  let filledStr = char.repeat(filled);
+  const emptyStr = emptyChar.repeat(empty);
+  if (rgb) filledStr = fgRgb(rgb.r, rgb.g, rgb.b) + filledStr + reset();
+  const pct = showPercentage ? ` ${String(Math.round(clamped)).padStart(3)}%` : "";
+  const lbl = label ? ` ${label}` : "";
+  write(screen.clearLine() + `\r[${filledStr}${emptyStr}]${pct}${lbl}`);
+};
+var progressAnimate = async (steps, label = "", opts = {}) => {
+  const { delay = 100, signal, ...barOpts } = opts;
+  const safeSteps2 = Math.max(1, steps);
+  write(cursor.hide());
+  try {
+    for (let i = 0; i <= safeSteps2; i++) {
+      if (signal?.aborted) break;
+      progress(i / safeSteps2 * 100, label, barOpts);
+      await sleep(delay);
+    }
+    writeln();
+  } finally {
+    write(cursor.show());
+  }
+};
+var tasks = async (taskList, opts = {}) => {
+  const { type = "dots", spinColor = "#00ff88", parallel = false } = opts;
+  if (!taskList.length) return [];
+  const runTask = async ({ text, fn }) => {
+    const stop = spin(text, { type, color: spinColor, reducedMotion: parallel });
+    try {
+      const result = await fn();
+      stop(text, true);
+      return { success: true, result };
+    } catch (err) {
+      stop(`${text} \u2014 ${err.message}`, false);
+      return { success: false, error: err };
+    }
+  };
+  if (parallel) {
+    return Promise.all(taskList.map(runTask));
+  }
+  const results = [];
+  for (const task of taskList) {
+    results.push(await runTask(task));
+  }
+  return results;
+};
+var custom = (frames2, text = "", opts = {}) => {
+  const { interval = 100, signal } = opts;
+  if (!frames2.length) throw new Error("custom: frames cannot be empty");
+  if (!isTTY2()) {
+    write(text + "\n");
+    return () => {
+    };
+  }
+  let i = 0;
+  let stopped = false;
+  write(cursor.hide());
+  const stop = () => {
+    if (stopped) return;
+    stopped = true;
+    clearInterval(timer);
+    write(cursor.show() + screen.clearLine() + "\r");
+  };
+  if (signal) signal.addEventListener("abort", stop, { once: true });
+  const timer = setInterval(() => {
+    if (stopped) return;
+    write(cursor.save() + screen.clearLine() + `\r${frames2[i % frames2.length]} ${text}` + cursor.restore());
+    i++;
+  }, interval);
+  return stop;
+};
+var countdown = async (seconds, opts = {}) => {
+  const { label = "Starting in", color: colorStr = "#ffd700", signal } = opts;
+  const rgb = safeColor(colorStr) ?? { r: 255, g: 215, b: 0 };
+  write(cursor.hide());
+  try {
+    for (let s = seconds; s >= 0; s--) {
+      if (signal?.aborted) break;
+      write(screen.clearLine() + `\r${label} ${fgRgb(rgb.r, rgb.g, rgb.b)}${s}${reset()}s`);
+      if (s > 0) await sleep(1e3);
+    }
+    write(screen.clearLine() + "\r");
+  } finally {
+    write(cursor.show());
+  }
+};
+var loader = {
+  spin,
+  dots,
+  progress,
+  progressAnimate,
+  tasks,
+  custom,
+  countdown,
+  spinners: SPINNERS
+};
+
+// src/frames/index.ts
+var lineCount = (frame) => frame.split("\n").length;
+var clearLines = (n) => {
+  for (let i = 0; i < n; i++) {
+    write("\r" + screen.clearLine() + cursor.up(1));
+  }
+};
+var play = async (frames2, opts = {}) => {
+  const {
+    interval = 100,
+    repeat = 1,
+    clearOnFinish = false,
+    onFrame = null,
+    signal
+  } = opts;
+  if (!frames2 || frames2.length === 0) return;
+  const safeRepeat = Math.max(0, repeat);
+  const infinite = repeat === 0;
+  let lastLines = 0;
+  let iteration = 0;
+  const renderFrame = (frame, idx) => {
+    if (lastLines > 0) clearLines(lastLines);
+    const rendered = onFrame ? onFrame(frame, idx) : frame;
+    write(rendered);
+    lastLines = lineCount(rendered) + (rendered.endsWith("\n") ? 0 : 1);
+    if (!rendered.endsWith("\n")) writeln();
+  };
+  write(cursor.hide());
+  try {
+    while (infinite || iteration < safeRepeat) {
+      for (let i = 0; i < frames2.length; i++) {
+        if (signal?.aborted) return;
+        renderFrame(frames2[i], i);
+        await sleep(interval);
+      }
+      iteration++;
+      if (!infinite && iteration >= safeRepeat) break;
+    }
+    if (clearOnFinish && lastLines > 0) clearLines(lastLines);
+  } finally {
+    write(cursor.show());
+  }
+};
+var generate = (count, fn) => Array.from({ length: Math.max(0, count) }, (_, i) => fn(i, count));
+var live = (opts = {}) => {
+  const { fps = 12, autoStart = true } = opts;
+  const safeFps = Math.max(1, fps);
+  const interval = Math.floor(1e3 / safeFps);
+  let currentFrame = "";
+  let lastLines = 0;
+  let running = false;
+  let timer = null;
+  const render = () => {
+    if (lastLines > 0) clearLines(lastLines);
+    write(currentFrame);
+    lastLines = lineCount(currentFrame) + (currentFrame.endsWith("\n") ? 0 : 1);
+    if (!currentFrame.endsWith("\n")) writeln();
+  };
+  const start = () => {
+    if (running) return;
+    running = true;
+    write(cursor.hide());
+    timer = setInterval(render, interval);
+  };
+  const stop = () => {
+    running = false;
+    if (timer) {
+      clearInterval(timer);
+      timer = null;
+    }
+    write(cursor.show());
+  };
+  const update = (newFrame) => {
+    currentFrame = newFrame;
+    if (running) render();
+  };
+  if (autoStart) start();
+  return { start, stop, update };
+};
+var morph = (frameA, frameB, steps = 8, charset = "\u2591\u2592\u2593\u2588\u2593\u2592\u2591") => {
+  const n = Math.max(2, steps);
+  const len = Math.max(frameA.length, frameB.length);
+  const a = frameA.padEnd(len);
+  const b = frameB.padEnd(len);
+  return generate(n, (i) => {
+    const t = i / (n - 1);
+    return [...Array(len)].map((_, ci) => {
+      const ca = a[ci];
+      const cb = b[ci];
+      if (t === 0) return ca;
+      if (t === 1) return cb;
+      if (ca !== cb) {
+        if (!charset.length) return "\u2591";
+        const idx = Math.floor(t * charset.length) % charset.length;
+        return charset[idx];
+      }
+      return ca;
+    }).join("");
+  });
+};
+var presets2 = {
+  loadingBar: (opts = {}) => {
+    const { width = 20, char = "\u2588", empty = "\u2591", label = "Loading" } = opts;
+    return generate(width + 1, (i) => {
+      const filled = char.repeat(i);
+      const rest = empty.repeat(width - i);
+      const pct = Math.round(i / width * 100);
+      return `${label} [${filled}${rest}] ${pct}%`;
+    });
+  },
+  ball: (opts = {}) => {
+    const { width = 20, char = "\u25CF" } = opts;
+    const forward = generate(width, (i) => " ".repeat(i) + char);
+    const backward = generate(width, (i) => " ".repeat(width - i - 1) + char);
+    return [...forward, ...backward.slice(1, -1).reverse()];
+  },
+  breathe: (text, opts = {}) => {
+    const { steps = 8 } = opts;
+    const shades = ["\u2591", "\u2592", "\u2593", "\u2588"];
+    return generate(steps * 2, (i) => {
+      const t = i < steps ? i / steps : 1 - (i - steps) / steps;
+      const shade = shades[Math.min(shades.length - 1, Math.floor(t * shades.length))];
+      return text.split("").map((ch) => ch === " " ? " " : shade).join("");
+    });
+  },
+  typeDelete: (text, opts = {}) => {
+    const { cursor: cur = "\u258C" } = opts;
+    const typed = generate(text.length + 1, (i) => text.slice(0, i) + cur);
+    const deleted = generate(text.length + 1, (i) => text.slice(0, text.length - i) + cur);
+    return [...typed, ...deleted];
+  }
+};
+var frames = { play, generate, live, morph, presets: presets2 };
+
+// src/components/index.ts
+var TABLE_BORDERS = {
+  single: { tl: "\u250C", tr: "\u2510", bl: "\u2514", br: "\u2518", h: "\u2500", v: "\u2502", ml: "\u251C", mr: "\u2524", mt: "\u252C", mb: "\u2534", cx: "\u253C" },
+  double: { tl: "\u2554", tr: "\u2557", bl: "\u255A", br: "\u255D", h: "\u2550", v: "\u2551", ml: "\u2560", mr: "\u2563", mt: "\u2566", mb: "\u2569", cx: "\u256C" },
+  rounded: { tl: "\u256D", tr: "\u256E", bl: "\u2570", br: "\u256F", h: "\u2500", v: "\u2502", ml: "\u251C", mr: "\u2524", mt: "\u252C", mb: "\u2534", cx: "\u253C" },
+  heavy: { tl: "\u250F", tr: "\u2513", bl: "\u2517", br: "\u251B", h: "\u2501", v: "\u2503", ml: "\u2523", mr: "\u252B", mt: "\u2533", mb: "\u253B", cx: "\u254B" }
+};
+var table = (rows, opts = {}) => {
+  const { header = true, borderStyle = "rounded", padding = 1 } = opts;
+  if (!rows || rows.length === 0) return "";
+  const b = TABLE_BORDERS[borderStyle] ?? TABLE_BORDERS.rounded;
+  const pad = " ".repeat(padding);
+  const cols = Math.max(...rows.map((r) => r.length), 0);
+  const widths = Array.from(
+    { length: cols },
+    (_, ci) => Math.max(...rows.map((r) => visibleLen(String(r[ci] ?? ""))))
+  );
+  const rowSep = (left, mid, right, fill) => left + widths.map((w) => fill.repeat(w + padding * 2)).join(mid) + right;
+  const renderRow = (row, isHeader = false) => {
+    const cells = row.map((cell, ci) => {
+      let s = padEnd(String(cell ?? ""), widths[ci] ?? 0);
+      if (isHeader) s = sgr(STYLE.bold) + s + reset();
+      return pad + s + pad;
+    });
+    return b.v + cells.join(b.v) + b.v;
+  };
+  const lines = [];
+  lines.push(rowSep(b.tl, b.mt, b.tr, b.h));
+  rows.forEach((row, ri) => {
+    lines.push(renderRow(row, ri === 0 && header));
+    if (ri === 0 && header && rows.length > 1) lines.push(rowSep(b.ml, b.cx, b.mr, b.h));
+  });
+  lines.push(rowSep(b.bl, b.mb, b.br, b.h));
+  return lines.join("\n");
+};
+var badge = (label, value, opts = {}) => {
+  const { labelBg = BG.blue, valueBg = BG.green, labelFg = FG.white, valueFg = FG.white } = opts;
+  return sgr(labelBg, labelFg) + ` ${label} ` + reset() + sgr(valueBg, valueFg) + ` ${value} ` + reset();
+};
+var progressBar = (percent, opts = {}) => {
+  const { width = 30, char = "\u2588", emptyChar = "\u2591", showPercentage = true, label = "", color: color2 = null } = opts;
+  const clamped = Math.min(100, Math.max(0, percent));
+  const filled = Math.round(clamped / 100 * width);
+  const empty = width - filled;
+  let filledStr = char.repeat(filled);
+  const emptyStr = emptyChar.repeat(empty);
+  if (color2 !== null) filledStr = sgr(color2) + filledStr + reset();
+  const pct = showPercentage ? ` ${String(Math.round(clamped)).padStart(3)}%` : "";
+  const lbl = label ? ` ${label}` : "";
+  return `[${filledStr}${emptyStr}]${pct}${lbl}`;
+};
+var STATUS_MAP = {
+  success: { icon: "\u2713", color: FG.green },
+  error: { icon: "\u2717", color: FG.red },
+  warn: { icon: "\u26A0", color: FG.yellow },
+  info: { icon: "\u2139", color: FG.cyan },
+  wait: { icon: "\u25CC", color: FG.brightBlack }
+};
+var status = (type, message) => {
+  const { icon, color: color2 } = STATUS_MAP[type] ?? STATUS_MAP.info;
+  return sgr(color2) + icon + reset() + " " + message;
+};
+var section = (title, opts = {}) => {
+  const { char = "\u2500", width = null, color: colorCode = FG.cyan } = opts;
+  const { cols } = termSize();
+  const w = Math.max(width ?? cols, title.length + 2);
+  const side = Math.floor((w - title.length - 2) / 2);
+  const divider2 = sgr(colorCode) + char.repeat(side) + reset();
+  const t = sgr(STYLE.bold, colorCode) + title + reset();
+  const trail = sgr(colorCode) + char.repeat(Math.max(0, w - side - title.length - 2)) + reset();
+  return divider2 + " " + t + " " + trail;
+};
+var columns = (items, opts = {}) => {
+  const { cols: numCols = 2, gap = 2, width = null } = opts;
+  if (numCols < 1) throw new Error("columns: cols must be >= 1");
+  const { cols: termCols } = termSize();
+  const totalW = width ?? termCols;
+  const colW = Math.floor((totalW - gap * (numCols - 1)) / numCols);
+  const rows = [];
+  for (let i = 0; i < items.length; i += numCols) {
+    const chunk = items.slice(i, i + numCols);
+    rows.push(chunk.map((item) => padEnd(String(item), colW)).join(" ".repeat(gap)));
+  }
+  return rows.join("\n");
+};
+var timeline = (events, opts = {}) => {
+  const {
+    connector = "\u2502",
+    node = "\u25CF",
+    color: colorCode = FG.cyan,
+    doneColor = FG.green,
+    pendingColor = FG.brightBlack
+  } = opts;
+  const lines = [];
+  events.forEach((ev, i) => {
+    const isLast = i === events.length - 1;
+    const clr = ev.done ? doneColor : i === 0 ? colorCode : pendingColor;
+    const nodeStr = sgr(clr) + node + reset();
+    const textStr = ev.done ? sgr(STYLE.bold) + ev.label + reset() : sgr(pendingColor) + ev.label + reset();
+    lines.push(`${nodeStr} ${textStr}${ev.time ? sgr(FG.brightBlack) + "  " + ev.time + reset() : ""}`);
+    if (!isLast) lines.push(sgr(pendingColor) + connector + reset());
+  });
+  return lines.join("\n");
+};
+var MENU_CANCELLED = /* @__PURE__ */ Symbol("MENU_CANCELLED");
+var menu = (items, opts = {}) => {
+  const {
+    title = null,
+    pointer = "\u25B6",
+    multiSelect = false,
+    color: colorCode = FG.cyan,
+    input: inp = process.stdin,
+    output: out = { write: (s) => process.stdout.write(s) }
+  } = opts;
+  if (!items.length) throw new Error("menu requires at least one item");
+  if (!inp.isTTY) return Promise.resolve(multiSelect ? [] : 0);
+  let cursorPos = 0;
+  const selected = /* @__PURE__ */ new Set();
+  const emit = (str) => {
+    out.write(str);
+  };
+  const render = () => {
+    if (title) emit(sgr(STYLE.bold) + title + reset() + "\n");
+    items.forEach((item, i) => {
+      const isActive = i === cursorPos;
+      const isSelected = selected.has(i);
+      const ptr = isActive ? sgr(colorCode) + pointer + reset() : " ";
+      const sel = multiSelect ? isSelected ? sgr(colorCode) + "\u25CF" + reset() : "\u25CB" : "";
+      const txt = isActive ? sgr(STYLE.bold, colorCode) + item + reset() : item;
+      emit(`${ptr} ${sel}${multiSelect ? " " : ""}${txt}
+`);
+    });
+  };
+  const clearLines2 = () => {
+    const lines = items.length + (title ? 1 : 0);
+    for (let i = 0; i < lines; i++) emit(cursor.up(1) + screen.clearLine());
+    emit("\r");
+  };
+  const cleanup = (onKey) => {
+    inp.removeListener("data", onKey);
+    if (inp.setRawMode) inp.setRawMode(false);
+    emit(cursor.show());
+  };
+  emit(cursor.hide());
+  render();
+  return new Promise((resolve) => {
+    const onKey = (...args) => {
+      const key = args[0];
+      const k = key.toString();
+      const KEY_UP = "\x1B[A";
+      const KEY_DOWN = "\x1B[B";
+      const KEY_ENTER = "\r";
+      const KEY_SPACE = " ";
+      const KEY_CTRL_C = "";
+      if (k === KEY_CTRL_C) {
+        clearLines2();
+        cleanup(onKey);
+        resolve(MENU_CANCELLED);
+        return;
+      }
+      if (k === KEY_UP || k === "k" || k === "w") {
+        cursorPos = (cursorPos - 1 + items.length) % items.length;
+      } else if (k === KEY_DOWN || k === "j" || k === "s") {
+        cursorPos = (cursorPos + 1) % items.length;
+      } else if (k === KEY_SPACE && multiSelect) {
+        if (selected.has(cursorPos)) selected.delete(cursorPos);
+        else selected.add(cursorPos);
+      } else if (k === KEY_ENTER) {
+        clearLines2();
+        cleanup(onKey);
+        resolve(multiSelect ? selected.size ? [...selected] : [cursorPos] : cursorPos);
+        return;
+      }
+      clearLines2();
+      render();
+    };
+    if (inp.setRawMode) inp.setRawMode(true);
+    inp.resume();
+    inp.on("data", onKey);
+  });
+};
+var components = { table, badge, progressBar, status, section, columns, timeline, menu };
+
+// src/themes/index.ts
+var THEMES = {
+  dracula: { name: "Dracula", primary: "#bd93f9", secondary: "#ff79c6", accent: "#50fa7b", warning: "#f1fa8c", error: "#ff5555", info: "#8be9fd", muted: "#6272a4", bg: "#282a36", surface: "#44475a", text: "#f8f8f2", gradient: ["#bd93f9", "#ff79c6"] },
+  nord: { name: "Nord", primary: "#88c0d0", secondary: "#81a1c1", accent: "#a3be8c", warning: "#ebcb8b", error: "#bf616a", info: "#5e81ac", muted: "#4c566a", bg: "#2e3440", surface: "#3b4252", text: "#eceff4", gradient: ["#88c0d0", "#81a1c1"] },
+  monokai: { name: "Monokai", primary: "#a6e22e", secondary: "#66d9e8", accent: "#f92672", warning: "#fd971f", error: "#f92672", info: "#66d9e8", muted: "#75715e", bg: "#272822", surface: "#3e3d32", text: "#f8f8f2", gradient: ["#a6e22e", "#66d9e8"] },
+  cyberpunk: { name: "Cyberpunk", primary: "#ff2d78", secondary: "#00fff5", accent: "#ffe801", warning: "#ff8800", error: "#ff2d78", info: "#00fff5", muted: "#444466", bg: "#0d0d1a", surface: "#1a1a2e", text: "#e0e0ff", gradient: ["#ff2d78", "#00fff5", "#ffe801"] },
+  pastel: { name: "Pastel", primary: "#a29bfe", secondary: "#fd79a8", accent: "#55efc4", warning: "#ffeaa7", error: "#e17055", info: "#74b9ff", muted: "#b2bec3", bg: "#f8f9fa", surface: "#ffffff", text: "#2d3436", gradient: ["#a29bfe", "#fd79a8", "#74b9ff"] },
+  matrix: { name: "Matrix", primary: "#00ff41", secondary: "#008f11", accent: "#00ff41", warning: "#aaff00", error: "#ff0000", info: "#00cc33", muted: "#003b00", bg: "#0d0208", surface: "#001a00", text: "#00ff41", gradient: ["#00ff41", "#003b00"] },
+  ocean: { name: "Ocean", primary: "#0099ff", secondary: "#00d2d3", accent: "#ffd32a", warning: "#ffa502", error: "#ff4757", info: "#70a1ff", muted: "#57606f", bg: "#0a1628", surface: "#0f2942", text: "#dfe6e9", gradient: ["#0099ff", "#00d2d3"] },
+  sunset: { name: "Sunset", primary: "#fd7272", secondary: "#f9ca24", accent: "#6ab04c", warning: "#f0932b", error: "#eb4d4b", info: "#22a6b3", muted: "#95afc0", bg: "#1a1a2e", surface: "#16213e", text: "#f5f6fa", gradient: ["#fd7272", "#f9ca24", "#6ab04c"] }
+};
+var _active = THEMES["dracula"];
+var apply = (colorHex) => (text) => {
+  const { r, g, b } = hexToRgb(colorHex);
+  return fgRgb(r, g, b) + text + reset();
+};
+var themes = {
+  list: () => Object.keys(THEMES),
+  get: (name) => THEMES[name] ?? null,
+  use(name) {
+    const t = THEMES[name];
+    if (!t) throw new Error(`Theme "${name}" not found. Available: ${Object.keys(THEMES).join(", ")}`);
+    _active = t;
+    return themes;
+  },
+  current: () => _active,
+  primary: (text) => apply(_active.primary)(text),
+  secondary: (text) => apply(_active.secondary)(text),
+  accent: (text) => apply(_active.accent)(text),
+  warning: (text) => apply(_active.warning)(text),
+  error: (text) => apply(_active.error)(text),
+  info: (text) => apply(_active.info)(text),
+  muted: (text) => apply(_active.muted)(text),
+  text: (text) => apply(_active.text)(text),
+  bold: (text) => sgr(STYLE.bold) + text + reset(),
+  gradient: (text) => gradient(text, _active.gradient),
+  register: (name, def) => {
+    THEMES[name] = def;
+  },
+  preview: () => {
+    const orig = _active;
+    Object.values(THEMES).forEach((t) => {
+      _active = t;
+      console.log(
+        gradient(`  ${t.name}  `, t.gradient) + "  " + themes.primary("primary") + "  " + themes.secondary("secondary") + "  " + themes.accent("accent") + "  " + themes.error("error") + "  " + themes.warning("warning")
+      );
+    });
+    _active = orig;
+  }
+};
+
+// src/images/index.ts
+var FULL_BLOCK = "\u2588";
+var UPPER_HALF = "\u2580";
+var HEX_RE4 = /^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
+var safeHex2 = (h) => {
+  if (!HEX_RE4.test(h.trim())) return null;
+  return hexToRgb(h);
+};
+var toRgb = (p) => p ?? { r: 0, g: 0, b: 0 };
+var renderPixelArt = (pixels, opts = {}) => {
+  const { scale = 1, halfBlock = true } = opts;
+  if (!pixels.length) return "";
+  const lines = [];
+  if (halfBlock) {
+    for (let row = 0; row < pixels.length; row += 2) {
+      let line = "";
+      const topRow = pixels[row] ?? [];
+      const botRow = pixels[row + 1] ?? [];
+      for (let col = 0; col < topRow.length; col++) {
+        const top = topRow[col] ?? null;
+        const bot = botRow[col] ?? null;
+        if (!top && !bot) {
+          line += " ".repeat(scale);
+          continue;
+        }
+        let cell = "";
+        for (let s = 0; s < scale; s++) {
+          if (top && bot) {
+            const t = toRgb(top), b = toRgb(bot);
+            cell += fgRgb(t.r, t.g, t.b) + bgRgb(b.r, b.g, b.b) + UPPER_HALF + reset();
+          } else if (top) {
+            const { r, g, b } = toRgb(top);
+            cell += fgRgb(r, g, b) + FULL_BLOCK + reset();
+          } else {
+            const { r, g, b } = toRgb(bot);
+            cell += fgRgb(r, g, b) + "\u2584" + reset();
+          }
+        }
+        line += cell;
+      }
+      lines.push(line);
+    }
+  } else {
+    for (const row of pixels) {
+      let line = "";
+      for (const pixel of row) {
+        if (!pixel) line += " ".repeat(scale);
+        else {
+          const { r, g, b } = pixel;
+          line += fgRgb(r, g, b) + FULL_BLOCK.repeat(scale) + reset();
+        }
+      }
+      lines.push(line);
+    }
+  }
+  return lines.join("\n");
+};
+var R = { r: 255, g: 0, b: 0 };
+var Y = { r: 255, g: 220, b: 0 };
+var G = { r: 255, g: 215, b: 0 };
+var K = { r: 0, g: 0, b: 0 };
+var N = null;
+var SPRITES = {
+  heart: { pixels: [
+    [N, R, N, R, N],
+    [R, R, R, R, R],
+    [R, R, R, R, R],
+    [N, R, R, R, N],
+    [N, N, R, N, N]
+  ] },
+  star: { pixels: [
+    [N, G, N, G, N],
+    [G, G, G, G, G],
+    [N, G, G, G, N],
+    [G, N, G, N, G],
+    [N, N, G, N, N]
+  ] },
+  smiley: { pixels: [
+    [N, Y, Y, Y, N],
+    [Y, K, Y, K, Y],
+    [Y, Y, Y, Y, Y],
+    [Y, K, Y, K, Y],
+    [N, Y, Y, Y, N]
+  ] },
+  pacman: { pixels: [
+    [N, Y, Y, Y, N],
+    [Y, Y, Y, N, N],
+    [Y, Y, N, N, N],
+    [Y, Y, Y, N, N],
+    [N, Y, Y, Y, N]
+  ] }
+};
+var flipHorizontal = (pixels) => pixels.map((row) => [...row].reverse());
+var flipVertical = (pixels) => [...pixels].reverse();
+var rotate90 = (pixels) => {
+  if (!pixels.length || !pixels[0]?.length) return pixels;
+  const rows = pixels.length;
+  const cols = pixels[0].length;
+  return Array.from(
+    { length: cols },
+    (_, c) => Array.from({ length: rows }, (__, r) => pixels[rows - 1 - r]?.[c] ?? null)
+  );
+};
+var gradientRect = (opts = {}) => {
+  const {
+    width = 40,
+    height = 10,
+    colors = ["#ff0000", "#0000ff"],
+    style = "horizontal"
+  } = opts;
+  const stops = colors.map(safeHex2).filter((c) => c !== null);
+  if (stops.length < 2) throw new Error("gradientRect: at least 2 valid hex color stops required");
+  const safeW = Math.max(2, width);
+  const safeH = Math.max(2, height);
+  const pixels = [];
+  for (let row = 0; row < safeH; row++) {
+    const line = [];
+    for (let col = 0; col < safeW; col++) {
+      let t;
+      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 {
+        const cx = safeW / 2, cy = safeH / 2;
+        const dx = (col - cx) / cx;
+        const dy = (row - cy) / cy;
+        t = clamp(Math.sqrt(dx * dx + dy * dy) / Math.SQRT2, 0, 1);
+      }
+      const scaled = t * (stops.length - 1);
+      const lo = Math.floor(scaled);
+      const hi = Math.min(lo + 1, stops.length - 1);
+      line.push(lerpColor(stops[lo], stops[hi], scaled - lo));
+    }
+    pixels.push(line);
+  }
+  return renderPixelArt(pixels, { scale: 1, halfBlock: true });
+};
+var createCanvas = (width, height, fillColor = null) => {
+  const pixels = Array.from(
+    { length: height },
+    () => Array.from({ length: width }, () => fillColor ? { ...fillColor } : null)
+  );
+  return {
+    set(x, y, color2) {
+      if (y >= 0 && y < height && x >= 0 && x < width) pixels[y][x] = color2;
+    },
+    get(x, y) {
+      return pixels[y]?.[x] ?? null;
+    },
+    fill(color2) {
+      for (let y = 0; y < height; y++)
+        for (let x = 0; x < width; x++)
+          pixels[y][x] = color2 ? { ...color2 } : null;
+    },
+    drawRect(x, y, w, h, color2, fill = false) {
+      for (let dy = y; dy < y + h; dy++)
+        for (let dx = x; dx < x + w; dx++)
+          if (fill || dy === y || dy === y + h - 1 || dx === x || dx === x + w - 1)
+            this.set(dx, dy, color2);
+    },
+    drawCircle(cx, cy, radius, color2, fill = false) {
+      const r2 = radius * radius;
+      for (let y = 0; y < height; y++)
+        for (let x = 0; x < width; x++) {
+          const dx = x - cx, dy = y - cy;
+          const d2 = dx * dx + dy * dy;
+          if (fill ? d2 <= r2 : Math.abs(Math.sqrt(d2) - radius) <= 0.7)
+            this.set(x, y, color2);
+        }
+    },
+    render(opts = {}) {
+      return renderPixelArt(pixels, opts);
+    },
+    // Use write() instead of console.log for consistency with the I/O layer
+    print(opts = {}) {
+      write(this.render(opts) + "\n");
+    },
+    width,
+    height,
+    pixels
+  };
+};
+var images = {
+  render: renderPixelArt,
+  sprites: SPRITES,
+  flipHorizontal,
+  flipVertical,
+  rotate90,
+  sprite(name, opts = {}) {
+    const s = SPRITES[name];
+    if (!s) throw new Error(`Sprite "${name}" not found. Available: ${Object.keys(SPRITES).join(", ")}`);
+    return renderPixelArt(s.pixels, opts);
+  },
+  gradientRect,
+  createCanvas
+};
+
+// src/configure.ts
+var _config = {
+  colorMode: "truecolor",
+  animationSpeed: "normal",
+  asciiFont: "big",
+  locale: "es",
+  theme: "dracula"
+};
+var SPEED_MAP = {
+  slow: 2,
+  normal: 1,
+  fast: 0.4
+};
+var configure = (opts = {}) => {
+  Object.assign(_config, opts);
+};
+var getConfig = () => ({ ..._config });
+var getSpeedMultiplier = () => SPEED_MAP[_config.animationSpeed] ?? 1;
+
+// src/index.ts
+var ansimax = { color, animate, ascii, loader, frames, components, themes, images, configure };
+var index_default = ansimax;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SPINNERS,
+  SPRITES,
+  animate,
+  ascii,
+  bgRgb,
+  center,
+  clamp,
+  color,
+  colorPresets,
+  components,
+  compose,
+  configure,
+  createCanvas,
+  cursor,
+  fgRgb,
+  frames,
+  getConfig,
+  getSpeedMultiplier,
+  gradient,
+  gradientRect,
+  hexToRgb,
+  images,
+  isHexColor,
+  isNoColor,
+  lerp,
+  lerpColor,
+  loader,
+  padEnd,
+  padStart,
+  rainbow,
+  renderPixelArt,
+  repeatVisible,
+  reset,
+  resetNoColor,
+  rgbTo256,
+  rgbToHex,
+  screen,
+  setNoColor,
+  sgr,
+  sleep,
+  stripAnsi,
+  supportsColor,
+  termSize,
+  themes,
+  truncateAnsi,
+  visibleLen,
+  wordWrap,
+  write,
+  writeln
+});