ansimax 1.2.4 → 1.2.6

package/dist/index.js

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ASCII_RAMPS: () => ASCII_RAMPS,
   BEL: () => BEL,
   BG: () => BG,
   CONFIG_DEFAULTS: () => DEFAULTS,
@@ -80,11 +81,13 @@ __export(index_exports, {
   escapeRegex: () => escapeRegex,
   fg256: () => fg256,
   fgRgb: () => fgRgb,
+  figletText: () => figletText,
   filterTree: () => filterTree,
   findInTree: () => findInTree,
   flipHorizontal: () => flipHorizontal,
   flipVertical: () => flipVertical,
   frames: () => frames,
+  fromImage: () => fromImage,
   getConfig: () => getConfig,
   getConfigValue: () => getConfigValue,
   getRenderCacheSize: () => getRenderCacheSize,
@@ -118,6 +121,7 @@ __export(index_exports, {
   padBoth: () => padBoth,
   padEnd: () => padEnd,
   padStart: () => padStart,
+  parseFiglet: () => parseFiglet,
   pauseListeners: () => pauseListeners,
   presetNames: () => presetNames,
   presets: () => presets,
@@ -2515,6 +2519,304 @@ var stream = async function* (text, opts = {}) {
     yield i === lines.length - 1 ? line : line + "\n";
   }
 };
+var ASCII_RAMPS = {
+  standard: " .:-=+*#%@",
+  detailed: " .'`^\",:;Il!i><~+_-?][}{1)(|/tfjrxnuvczXYUJCLQ0OZmwqpdbkhao*#MW&8%B@$",
+  blocks: " \u2591\u2592\u2593\u2588",
+  simple: " .+#",
+  // v1.2.6 — new ramps
+  binary: " \u2588",
+  dots: " \u2801\u2803\u2807\u2827\u2837\u2877\u28F7\u28FF",
+  shades: " \u2801\u2803\u2807\u2827\u2837\u2877\u28F7\u28FF\u2588",
+  ascii64: " `.'^,_:-+=<>i!lI?/\\|()1{}[]rcvunxzjftLCJUYXZO0Qoahkbdpqwm*WMB8&%$#@"
+};
+var _resolveRamp = (r) => {
+  if (typeof r === "string" && r.length > 0) {
+    if (r in ASCII_RAMPS) return ASCII_RAMPS[r];
+    return r;
+  }
+  return ASCII_RAMPS.standard;
+};
+var _luminance = (p) => {
+  if (!p) return 0;
+  return 0.2126 * p.r + 0.7152 * p.g + 0.0722 * p.b;
+};
+var _sobelEdges = (pixels) => {
+  const h = pixels.length;
+  const w = h > 0 ? pixels[0].length : 0;
+  const out = Array.from({ length: h }, () => new Array(w).fill(0));
+  for (let y = 1; y < h - 1; y++) {
+    const rowPrev = pixels[y - 1];
+    const row = pixels[y];
+    const rowNext = pixels[y + 1];
+    const outRow = out[y];
+    for (let x = 1; x < w - 1; x++) {
+      const tl = _luminance(rowPrev[x - 1]);
+      const t = _luminance(rowPrev[x]);
+      const tr = _luminance(rowPrev[x + 1]);
+      const l = _luminance(row[x - 1]);
+      const r = _luminance(row[x + 1]);
+      const bl = _luminance(rowNext[x - 1]);
+      const b = _luminance(rowNext[x]);
+      const br = _luminance(rowNext[x + 1]);
+      const gx = -tl + tr - 2 * l + 2 * r - bl + br;
+      const gy = -tl - 2 * t - tr + bl + 2 * b + br;
+      const mag = Math.sqrt(gx * gx + gy * gy);
+      outRow[x] = Math.min(255, mag);
+    }
+  }
+  return out;
+};
+var _floydSteinberg = (lum, levels) => {
+  const h = lum.length;
+  if (h === 0) return lum;
+  const w = lum[0].length;
+  if (w === 0) return lum;
+  const out = lum.map((row) => [...row]);
+  const step = 255 / Math.max(1, levels - 1);
+  for (let y = 0; y < h; y++) {
+    const row = out[y];
+    for (let x = 0; x < w; x++) {
+      const oldPixel = row[x];
+      const quantLevel = Math.round(oldPixel / step);
+      const newPixel = quantLevel * step;
+      row[x] = newPixel;
+      const err = oldPixel - newPixel;
+      if (x + 1 < w) {
+        row[x + 1] = row[x + 1] + err * 7 / 16;
+      }
+      if (y + 1 < h) {
+        const next = out[y + 1];
+        if (x > 0) next[x - 1] = next[x - 1] + err * 3 / 16;
+        next[x] = next[x] + err * 5 / 16;
+        if (x + 1 < w) next[x + 1] = next[x + 1] + err * 1 / 16;
+      }
+    }
+  }
+  return out;
+};
+var _resizePixels = (pixels, targetW, targetH) => {
+  const srcH = pixels.length;
+  if (srcH === 0) return [];
+  const srcW = pixels[0].length;
+  if (srcW === 0) return [];
+  const out = [];
+  for (let y = 0; y < targetH; y++) {
+    const sy = Math.min(srcH - 1, Math.floor(y / targetH * srcH));
+    const srcRow = pixels[sy];
+    const newRow = new Array(targetW);
+    for (let x = 0; x < targetW; x++) {
+      const sx = Math.min(srcW - 1, Math.floor(x / targetW * srcW));
+      newRow[x] = srcRow[sx];
+    }
+    out.push(newRow);
+  }
+  return out;
+};
+var _toLuminanceGrid = (pixels) => {
+  return pixels.map((row) => row.map((p) => _luminance(p)));
+};
+var _enhanceForFace = (lum) => {
+  const flat = [];
+  for (const row of lum) for (const v of row) flat.push(v);
+  if (flat.length === 0) return lum;
+  flat.sort((a, b) => a - b);
+  const lo = flat[Math.floor(flat.length * 0.1)];
+  const hi = flat[Math.floor(flat.length * 0.9)];
+  const range = Math.max(1, hi - lo);
+  return lum.map(
+    (row) => row.map((v) => {
+      const stretched = (v - lo) / range * 255;
+      return Math.max(0, Math.min(255, stretched));
+    })
+  );
+};
+var _adjustBrightnessContrast = (lum, brightness, contrast) => {
+  const safeBrightness = Math.max(-1, Math.min(1, brightness)) * 255;
+  const safeContrast = Math.max(-1, Math.min(1, contrast));
+  const contrastFactor = 1 + safeContrast;
+  return lum.map(
+    (row) => row.map((v) => {
+      const adjusted = (v - 128) * contrastFactor + 128 + safeBrightness;
+      return Math.max(0, Math.min(255, adjusted));
+    })
+  );
+};
+var fromImage = (pixels, opts = {}) => {
+  if (!Array.isArray(pixels) || pixels.length === 0) return "";
+  const firstRow = pixels[0];
+  if (!Array.isArray(firstRow) || firstRow.length === 0) return "";
+  const {
+    width = 80,
+    ramp = "standard",
+    invert = false,
+    dither = "none",
+    edgeDetect = "none",
+    edgeThreshold = 40,
+    color: color2 = false,
+    faceMode = false,
+    // v1.2.6
+    bgColor = false,
+    brightness = 0,
+    contrast = 0
+  } = opts;
+  const srcH = pixels.length;
+  const srcW = pixels[0].length;
+  const safeW = Math.max(1, Math.floor(width));
+  const computedH = Math.max(1, Math.round(srcH / srcW * safeW * 0.5));
+  const safeH = opts.height != null ? Math.max(1, Math.floor(opts.height)) : computedH;
+  const resized = _resizePixels(pixels, safeW, safeH);
+  let lum = _toLuminanceGrid(resized);
+  if (brightness !== 0 || contrast !== 0) {
+    lum = _adjustBrightnessContrast(lum, brightness, contrast);
+  }
+  if (faceMode) lum = _enhanceForFace(lum);
+  let edgeGrid = null;
+  if (edgeDetect === "sobel") {
+    edgeGrid = _sobelEdges(resized);
+  }
+  const rampStr = _resolveRamp(ramp);
+  const rampLen = rampStr.length;
+  if (dither === "floyd-steinberg" && !edgeGrid) {
+    lum = _floydSteinberg(lum, rampLen);
+  }
+  const useColor = (color2 || bgColor) && !isNoColor();
+  const lines = [];
+  for (let y = 0; y < safeH; y++) {
+    const lumRow = lum[y];
+    const pxRow = resized[y];
+    const edgeRow = edgeGrid ? edgeGrid[y] : null;
+    let line = "";
+    for (let x = 0; x < safeW; x++) {
+      let charIdx;
+      if (edgeRow) {
+        const edge = edgeRow[x];
+        const t = edge >= edgeThreshold ? Math.min(1, edge / 255) : 0;
+        charIdx = invert ? Math.round((1 - t) * (rampLen - 1)) : Math.round(t * (rampLen - 1));
+      } else {
+        const l = lumRow[x] / 255;
+        const tNorm = invert ? 1 - l : l;
+        charIdx = Math.min(rampLen - 1, Math.max(0, Math.round(tNorm * (rampLen - 1))));
+      }
+      const ch = rampStr[charIdx];
+      if (useColor) {
+        const p = pxRow[x];
+        if (p) {
+          if (bgColor) {
+            line += bgRgb(p.r, p.g, p.b) + ch;
+          } else {
+            line += fgRgb(p.r, p.g, p.b) + ch;
+          }
+        } else {
+          line += ch;
+        }
+      } else {
+        line += ch;
+      }
+    }
+    if (useColor) line += reset();
+    lines.push(line);
+  }
+  return lines.join("\n");
+};
+var parseFiglet = (flfContent) => {
+  if (typeof flfContent !== "string" || flfContent.length === 0) {
+    throw new TypeError("parseFiglet: input must be a non-empty string");
+  }
+  const lines = flfContent.split(/\r?\n/);
+  if (lines.length === 0) {
+    throw new TypeError("parseFiglet: empty content");
+  }
+  const header = lines[0];
+  const m = /^flf2.\s*(\S)\s+(-?\d+)\s+(-?\d+)\s+(-?\d+)\s+(-?\d+)\s+(\d+)/.exec(header);
+  if (!m) {
+    throw new TypeError('parseFiglet: invalid FIGfont header (expected "flf2a$..." line)');
+  }
+  const hardblank = m[1];
+  const height = parseInt(m[2], 10);
+  const commentLines = parseInt(m[6], 10);
+  if (!Number.isFinite(height) || height <= 0) {
+    throw new TypeError(`parseFiglet: invalid height ${m[2]}`);
+  }
+  let cursor2 = 1 + Math.max(0, commentLines);
+  const glyphs = /* @__PURE__ */ new Map();
+  for (let code = 32; code <= 126; code++) {
+    if (cursor2 + height > lines.length) break;
+    const rows = [];
+    for (let r = 0; r < height; r++) {
+      const raw = lines[cursor2 + r];
+      const endmark = raw.charAt(raw.length - 1);
+      let stripped = raw;
+      while (stripped.length > 0 && stripped.charAt(stripped.length - 1) === endmark) {
+        stripped = stripped.slice(0, -1);
+      }
+      rows.push(stripped);
+    }
+    glyphs.set(code, rows);
+    cursor2 += height;
+  }
+  return { hardblank, height, glyphs };
+};
+var figletText = (text, font, opts = {}) => {
+  if (typeof text !== "string") return "";
+  if (!font || !font.glyphs || font.height <= 0) return "";
+  const {
+    trim = true,
+    colorFn = null,
+    // v1.2.6
+    kerning = 0,
+    lineSpacing = 0
+  } = opts;
+  const safeKerning = Math.max(0, Math.floor(kerning));
+  const safeLineSpacing = Math.max(0, Math.floor(lineSpacing));
+  if (text.includes("\n")) {
+    const linesOfText = text.split("\n");
+    const renderedBlocks = linesOfText.map(
+      (line) => _renderFigletLine(line, font, safeKerning, trim)
+    );
+    const spacer = safeLineSpacing > 0 ? "\n".repeat(safeLineSpacing + 1) : "\n";
+    let multiResult = renderedBlocks.join(spacer);
+    if (colorFn) multiResult = colorFn(multiResult);
+    return multiResult;
+  }
+  let result = _renderFigletLine(text, font, safeKerning, trim);
+  if (colorFn) result = colorFn(result);
+  return result;
+};
+var _renderFigletLine = (text, font, kerning, trim) => {
+  const glyphsForText = [];
+  for (const ch of text) {
+    const code = ch.codePointAt(0) ?? 32;
+    const glyph = font.glyphs.get(code);
+    if (glyph) {
+      glyphsForText.push(glyph);
+    } else {
+      const fallback = font.glyphs.get(32);
+      glyphsForText.push(fallback ?? new Array(font.height).fill(""));
+    }
+  }
+  const kerningSpacer = kerning > 0 ? " ".repeat(kerning) : "";
+  const hardblankRe = new RegExp(_escapeRe(font.hardblank), "g");
+  const rows = [];
+  for (let r = 0; r < font.height; r++) {
+    let row = "";
+    for (let i = 0; i < glyphsForText.length; i++) {
+      const g = glyphsForText[i];
+      row += g[r] ?? "";
+      if (i < glyphsForText.length - 1 && kerningSpacer) {
+        row += kerningSpacer;
+      }
+    }
+    row = row.replace(hardblankRe, " ");
+    rows.push(row);
+  }
+  if (trim) {
+    const trimmed = rows.filter((row) => row.trim().length > 0);
+    return trimmed.length > 0 ? trimmed.join("\n") : rows.join("\n");
+  }
+  return rows.join("\n");
+};
+var _escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 var ascii = {
   big,
   small,
@@ -2525,6 +2827,10 @@ var ascii = {
   logo,
   stream,
   measure,
+  // v1.2.5 — Phase 3 closure
+  fromImage,
+  figletText,
+  parseFiglet,
   // Pipeline stages — exposed for custom compositions
   stageRender,
   stageAlign,
@@ -5497,6 +5803,7 @@ var ansimax = { color, animate, ascii, loader, frames, components, trees, themes
 var index_default = ansimax;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ASCII_RAMPS,
   BEL,
   BG,
   CONFIG_DEFAULTS,
@@ -5546,11 +5853,13 @@ var index_default = ansimax;
   escapeRegex,
   fg256,
   fgRgb,
+  figletText,
   filterTree,
   findInTree,
   flipHorizontal,
   flipVertical,
   frames,
+  fromImage,
   getConfig,
   getConfigValue,
   getRenderCacheSize,
@@ -5584,6 +5893,7 @@ var index_default = ansimax;
   padBoth,
   padEnd,
   padStart,
+  parseFiglet,
   pauseListeners,
   presetNames,
   presets,

package/dist/index.mjs

@@ -2339,6 +2339,304 @@ var stream = async function* (text, opts = {}) {
     yield i === lines.length - 1 ? line : line + "\n";
   }
 };
+var ASCII_RAMPS = {
+  standard: " .:-=+*#%@",
+  detailed: " .'`^\",:;Il!i><~+_-?][}{1)(|/tfjrxnuvczXYUJCLQ0OZmwqpdbkhao*#MW&8%B@$",
+  blocks: " \u2591\u2592\u2593\u2588",
+  simple: " .+#",
+  // v1.2.6 — new ramps
+  binary: " \u2588",
+  dots: " \u2801\u2803\u2807\u2827\u2837\u2877\u28F7\u28FF",
+  shades: " \u2801\u2803\u2807\u2827\u2837\u2877\u28F7\u28FF\u2588",
+  ascii64: " `.'^,_:-+=<>i!lI?/\\|()1{}[]rcvunxzjftLCJUYXZO0Qoahkbdpqwm*WMB8&%$#@"
+};
+var _resolveRamp = (r) => {
+  if (typeof r === "string" && r.length > 0) {
+    if (r in ASCII_RAMPS) return ASCII_RAMPS[r];
+    return r;
+  }
+  return ASCII_RAMPS.standard;
+};
+var _luminance = (p) => {
+  if (!p) return 0;
+  return 0.2126 * p.r + 0.7152 * p.g + 0.0722 * p.b;
+};
+var _sobelEdges = (pixels) => {
+  const h = pixels.length;
+  const w = h > 0 ? pixels[0].length : 0;
+  const out = Array.from({ length: h }, () => new Array(w).fill(0));
+  for (let y = 1; y < h - 1; y++) {
+    const rowPrev = pixels[y - 1];
+    const row = pixels[y];
+    const rowNext = pixels[y + 1];
+    const outRow = out[y];
+    for (let x = 1; x < w - 1; x++) {
+      const tl = _luminance(rowPrev[x - 1]);
+      const t = _luminance(rowPrev[x]);
+      const tr = _luminance(rowPrev[x + 1]);
+      const l = _luminance(row[x - 1]);
+      const r = _luminance(row[x + 1]);
+      const bl = _luminance(rowNext[x - 1]);
+      const b = _luminance(rowNext[x]);
+      const br = _luminance(rowNext[x + 1]);
+      const gx = -tl + tr - 2 * l + 2 * r - bl + br;
+      const gy = -tl - 2 * t - tr + bl + 2 * b + br;
+      const mag = Math.sqrt(gx * gx + gy * gy);
+      outRow[x] = Math.min(255, mag);
+    }
+  }
+  return out;
+};
+var _floydSteinberg = (lum, levels) => {
+  const h = lum.length;
+  if (h === 0) return lum;
+  const w = lum[0].length;
+  if (w === 0) return lum;
+  const out = lum.map((row) => [...row]);
+  const step = 255 / Math.max(1, levels - 1);
+  for (let y = 0; y < h; y++) {
+    const row = out[y];
+    for (let x = 0; x < w; x++) {
+      const oldPixel = row[x];
+      const quantLevel = Math.round(oldPixel / step);
+      const newPixel = quantLevel * step;
+      row[x] = newPixel;
+      const err = oldPixel - newPixel;
+      if (x + 1 < w) {
+        row[x + 1] = row[x + 1] + err * 7 / 16;
+      }
+      if (y + 1 < h) {
+        const next = out[y + 1];
+        if (x > 0) next[x - 1] = next[x - 1] + err * 3 / 16;
+        next[x] = next[x] + err * 5 / 16;
+        if (x + 1 < w) next[x + 1] = next[x + 1] + err * 1 / 16;
+      }
+    }
+  }
+  return out;
+};
+var _resizePixels = (pixels, targetW, targetH) => {
+  const srcH = pixels.length;
+  if (srcH === 0) return [];
+  const srcW = pixels[0].length;
+  if (srcW === 0) return [];
+  const out = [];
+  for (let y = 0; y < targetH; y++) {
+    const sy = Math.min(srcH - 1, Math.floor(y / targetH * srcH));
+    const srcRow = pixels[sy];
+    const newRow = new Array(targetW);
+    for (let x = 0; x < targetW; x++) {
+      const sx = Math.min(srcW - 1, Math.floor(x / targetW * srcW));
+      newRow[x] = srcRow[sx];
+    }
+    out.push(newRow);
+  }
+  return out;
+};
+var _toLuminanceGrid = (pixels) => {
+  return pixels.map((row) => row.map((p) => _luminance(p)));
+};
+var _enhanceForFace = (lum) => {
+  const flat = [];
+  for (const row of lum) for (const v of row) flat.push(v);
+  if (flat.length === 0) return lum;
+  flat.sort((a, b) => a - b);
+  const lo = flat[Math.floor(flat.length * 0.1)];
+  const hi = flat[Math.floor(flat.length * 0.9)];
+  const range = Math.max(1, hi - lo);
+  return lum.map(
+    (row) => row.map((v) => {
+      const stretched = (v - lo) / range * 255;
+      return Math.max(0, Math.min(255, stretched));
+    })
+  );
+};
+var _adjustBrightnessContrast = (lum, brightness, contrast) => {
+  const safeBrightness = Math.max(-1, Math.min(1, brightness)) * 255;
+  const safeContrast = Math.max(-1, Math.min(1, contrast));
+  const contrastFactor = 1 + safeContrast;
+  return lum.map(
+    (row) => row.map((v) => {
+      const adjusted = (v - 128) * contrastFactor + 128 + safeBrightness;
+      return Math.max(0, Math.min(255, adjusted));
+    })
+  );
+};
+var fromImage = (pixels, opts = {}) => {
+  if (!Array.isArray(pixels) || pixels.length === 0) return "";
+  const firstRow = pixels[0];
+  if (!Array.isArray(firstRow) || firstRow.length === 0) return "";
+  const {
+    width = 80,
+    ramp = "standard",
+    invert = false,
+    dither = "none",
+    edgeDetect = "none",
+    edgeThreshold = 40,
+    color: color2 = false,
+    faceMode = false,
+    // v1.2.6
+    bgColor = false,
+    brightness = 0,
+    contrast = 0
+  } = opts;
+  const srcH = pixels.length;
+  const srcW = pixels[0].length;
+  const safeW = Math.max(1, Math.floor(width));
+  const computedH = Math.max(1, Math.round(srcH / srcW * safeW * 0.5));
+  const safeH = opts.height != null ? Math.max(1, Math.floor(opts.height)) : computedH;
+  const resized = _resizePixels(pixels, safeW, safeH);
+  let lum = _toLuminanceGrid(resized);
+  if (brightness !== 0 || contrast !== 0) {
+    lum = _adjustBrightnessContrast(lum, brightness, contrast);
+  }
+  if (faceMode) lum = _enhanceForFace(lum);
+  let edgeGrid = null;
+  if (edgeDetect === "sobel") {
+    edgeGrid = _sobelEdges(resized);
+  }
+  const rampStr = _resolveRamp(ramp);
+  const rampLen = rampStr.length;
+  if (dither === "floyd-steinberg" && !edgeGrid) {
+    lum = _floydSteinberg(lum, rampLen);
+  }
+  const useColor = (color2 || bgColor) && !isNoColor();
+  const lines = [];
+  for (let y = 0; y < safeH; y++) {
+    const lumRow = lum[y];
+    const pxRow = resized[y];
+    const edgeRow = edgeGrid ? edgeGrid[y] : null;
+    let line = "";
+    for (let x = 0; x < safeW; x++) {
+      let charIdx;
+      if (edgeRow) {
+        const edge = edgeRow[x];
+        const t = edge >= edgeThreshold ? Math.min(1, edge / 255) : 0;
+        charIdx = invert ? Math.round((1 - t) * (rampLen - 1)) : Math.round(t * (rampLen - 1));
+      } else {
+        const l = lumRow[x] / 255;
+        const tNorm = invert ? 1 - l : l;
+        charIdx = Math.min(rampLen - 1, Math.max(0, Math.round(tNorm * (rampLen - 1))));
+      }
+      const ch = rampStr[charIdx];
+      if (useColor) {
+        const p = pxRow[x];
+        if (p) {
+          if (bgColor) {
+            line += bgRgb(p.r, p.g, p.b) + ch;
+          } else {
+            line += fgRgb(p.r, p.g, p.b) + ch;
+          }
+        } else {
+          line += ch;
+        }
+      } else {
+        line += ch;
+      }
+    }
+    if (useColor) line += reset();
+    lines.push(line);
+  }
+  return lines.join("\n");
+};
+var parseFiglet = (flfContent) => {
+  if (typeof flfContent !== "string" || flfContent.length === 0) {
+    throw new TypeError("parseFiglet: input must be a non-empty string");
+  }
+  const lines = flfContent.split(/\r?\n/);
+  if (lines.length === 0) {
+    throw new TypeError("parseFiglet: empty content");
+  }
+  const header = lines[0];
+  const m = /^flf2.\s*(\S)\s+(-?\d+)\s+(-?\d+)\s+(-?\d+)\s+(-?\d+)\s+(\d+)/.exec(header);
+  if (!m) {
+    throw new TypeError('parseFiglet: invalid FIGfont header (expected "flf2a$..." line)');
+  }
+  const hardblank = m[1];
+  const height = parseInt(m[2], 10);
+  const commentLines = parseInt(m[6], 10);
+  if (!Number.isFinite(height) || height <= 0) {
+    throw new TypeError(`parseFiglet: invalid height ${m[2]}`);
+  }
+  let cursor2 = 1 + Math.max(0, commentLines);
+  const glyphs = /* @__PURE__ */ new Map();
+  for (let code = 32; code <= 126; code++) {
+    if (cursor2 + height > lines.length) break;
+    const rows = [];
+    for (let r = 0; r < height; r++) {
+      const raw = lines[cursor2 + r];
+      const endmark = raw.charAt(raw.length - 1);
+      let stripped = raw;
+      while (stripped.length > 0 && stripped.charAt(stripped.length - 1) === endmark) {
+        stripped = stripped.slice(0, -1);
+      }
+      rows.push(stripped);
+    }
+    glyphs.set(code, rows);
+    cursor2 += height;
+  }
+  return { hardblank, height, glyphs };
+};
+var figletText = (text, font, opts = {}) => {
+  if (typeof text !== "string") return "";
+  if (!font || !font.glyphs || font.height <= 0) return "";
+  const {
+    trim = true,
+    colorFn = null,
+    // v1.2.6
+    kerning = 0,
+    lineSpacing = 0
+  } = opts;
+  const safeKerning = Math.max(0, Math.floor(kerning));
+  const safeLineSpacing = Math.max(0, Math.floor(lineSpacing));
+  if (text.includes("\n")) {
+    const linesOfText = text.split("\n");
+    const renderedBlocks = linesOfText.map(
+      (line) => _renderFigletLine(line, font, safeKerning, trim)
+    );
+    const spacer = safeLineSpacing > 0 ? "\n".repeat(safeLineSpacing + 1) : "\n";
+    let multiResult = renderedBlocks.join(spacer);
+    if (colorFn) multiResult = colorFn(multiResult);
+    return multiResult;
+  }
+  let result = _renderFigletLine(text, font, safeKerning, trim);
+  if (colorFn) result = colorFn(result);
+  return result;
+};
+var _renderFigletLine = (text, font, kerning, trim) => {
+  const glyphsForText = [];
+  for (const ch of text) {
+    const code = ch.codePointAt(0) ?? 32;
+    const glyph = font.glyphs.get(code);
+    if (glyph) {
+      glyphsForText.push(glyph);
+    } else {
+      const fallback = font.glyphs.get(32);
+      glyphsForText.push(fallback ?? new Array(font.height).fill(""));
+    }
+  }
+  const kerningSpacer = kerning > 0 ? " ".repeat(kerning) : "";
+  const hardblankRe = new RegExp(_escapeRe(font.hardblank), "g");
+  const rows = [];
+  for (let r = 0; r < font.height; r++) {
+    let row = "";
+    for (let i = 0; i < glyphsForText.length; i++) {
+      const g = glyphsForText[i];
+      row += g[r] ?? "";
+      if (i < glyphsForText.length - 1 && kerningSpacer) {
+        row += kerningSpacer;
+      }
+    }
+    row = row.replace(hardblankRe, " ");
+    rows.push(row);
+  }
+  if (trim) {
+    const trimmed = rows.filter((row) => row.trim().length > 0);
+    return trimmed.length > 0 ? trimmed.join("\n") : rows.join("\n");
+  }
+  return rows.join("\n");
+};
+var _escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 var ascii = {
   big,
   small,
@@ -2349,6 +2647,10 @@ var ascii = {
   logo,
   stream,
   measure,
+  // v1.2.5 — Phase 3 closure
+  fromImage,
+  figletText,
+  parseFiglet,
   // Pipeline stages — exposed for custom compositions
   stageRender,
   stageAlign,
@@ -5320,6 +5622,7 @@ var withConfig = (overrides, fn) => {
 var ansimax = { color, animate, ascii, loader, frames, components, trees, themes, images, configure };
 var index_default = ansimax;
 export {
+  ASCII_RAMPS,
   BEL,
   BG,
   DEFAULTS as CONFIG_DEFAULTS,
@@ -5370,11 +5673,13 @@ export {
   escapeRegex,
   fg256,
   fgRgb,
+  figletText,
   filterTree,
   findInTree,
   flipHorizontal,
   flipVertical,
   frames,
+  fromImage,
   getConfig,
   getConfigValue,
   getRenderCacheSize,
@@ -5408,6 +5713,7 @@ export {
   padBoth,
   padEnd,
   padStart,
+  parseFiglet,
   pauseListeners,
   presetNames,
   presets,