asciify-engine 1.0.51 → 1.0.53

package/dist/index.d.cts

@@ -51,6 +51,11 @@ interface AsciiOptions {
      * The accent colour used when `colorMode` is `'accent'` or `'matrix'`.
      * Any CSS colour string. Default: `'#d4ff00'`
      */
+    /**
+     * Hex color string used when `colorMode` is `'accent'`.
+     * Set to `'auto'` to let the engine pick contrasting ink automatically:
+     * dark ink (`#0d0d0d`) in light mode, light ink (`#faf9f7`) in dark mode.
+     */
     accentColor: string;
     /**
      * Invert luminance mapping (light pixels → dense chars). Default: `false`

package/dist/index.d.ts

@@ -51,6 +51,11 @@ interface AsciiOptions {
      * The accent colour used when `colorMode` is `'accent'` or `'matrix'`.
      * Any CSS colour string. Default: `'#d4ff00'`
      */
+    /**
+     * Hex color string used when `colorMode` is `'accent'`.
+     * Set to `'auto'` to let the engine pick contrasting ink automatically:
+     * dark ink (`#0d0d0d`) in light mode, light ink (`#faf9f7`) in dark mode.
+     */
     accentColor: string;
     /**
      * Invert luminance mapping (light pixels → dense chars). Default: `false`

package/dist/index.js

@@ -212,7 +212,7 @@ for (let _i = 0; _i < 256; _i++) {
   GRAY_LUT[_i] = `rgb(${_i},${_i},${_i})`;
   GREEN_LUT[_i] = `rgb(0,${_i},0)`;
 }
-function getCellColorStr(cell, colorMode, acR, acG, acB) {
+function getCellColorStr(cell, colorMode, acR, acG, acB, isInverted = false) {
   switch (colorMode) {
     case "fullcolor":
       return `rgb(${cell.r},${cell.g},${cell.b})`;
@@ -222,12 +222,14 @@ function getCellColorStr(cell, colorMode, acR, acG, acB) {
       const ab = (0.299 * cell.r + 0.587 * cell.g + 0.114 * cell.b) / 255;
       return `rgb(${acR * ab | 0},${acG * ab | 0},${acB * ab | 0})`;
     }
-    default:
-      return GRAY_LUT[0.299 * cell.r + 0.587 * cell.g + 0.114 * cell.b | 0];
+    default: {
+      const gray = 0.299 * cell.r + 0.587 * cell.g + 0.114 * cell.b | 0;
+      return GRAY_LUT[isInverted ? 255 - gray : gray];
+    }
   }
 }
 var _colorRGB = [0, 0, 0];
-function getCellColorRGB(cell, colorMode, acR, acG, acB) {
+function getCellColorRGB(cell, colorMode, acR, acG, acB, isInverted = false) {
   switch (colorMode) {
     case "fullcolor":
       _colorRGB[0] = cell.r;
@@ -249,7 +251,8 @@ function getCellColorRGB(cell, colorMode, acR, acG, acB) {
       break;
     }
     default: {
-      const gray = 0.299 * cell.r + 0.587 * cell.g + 0.114 * cell.b | 0;
+      let gray = 0.299 * cell.r + 0.587 * cell.g + 0.114 * cell.b | 0;
+      if (isInverted) gray = 255 - gray;
       _colorRGB[0] = gray;
       _colorRGB[1] = gray;
       _colorRGB[2] = gray;
@@ -617,6 +620,14 @@ function resolveInvert(invert) {
   if (invert !== "auto") return invert;
   return typeof window !== "undefined" && !window.matchMedia("(prefers-color-scheme: dark)").matches;
 }
+function resolveAccentHex(accentColor) {
+  const v = accentColor || "auto";
+  if (v === "auto") {
+    const isDark = typeof window !== "undefined" && window.matchMedia("(prefers-color-scheme: dark)").matches;
+    return isDark ? "faf9f7" : "0d0d0d";
+  }
+  return v.replace("#", "");
+}
 function imageToAsciiFrame(source, options, targetWidth, targetHeight) {
   const srcWidth = source instanceof HTMLVideoElement ? source.videoWidth : source.width;
   const srcHeight = source instanceof HTMLVideoElement ? source.videoHeight : source.height;
@@ -781,7 +792,7 @@ async function gifToAsciiFrames(buffer, options, targetWidth, targetHeight, onPr
 function renderFrameToCanvas(ctx, frame, options, canvasWidth, canvasHeight, time = 0, hoverPos) {
   if (options.animationStyle === "waveField") {
     const mouseNorm = hoverPos ? { x: hoverPos.x, y: hoverPos.y } : { x: 0.5, y: 0.5 };
-    const acHexWF = (options.accentColor || "#d4ff00").replace("#", "");
+    const acHexWF = options.accentColor ? resolveAccentHex(options.accentColor) : "d4ff00";
     renderWaveBackground(ctx, canvasWidth, canvasHeight, time, mouseNorm, {
       accentColor: `#${acHexWF}`,
       accentThreshold: 0.52,
@@ -826,7 +837,7 @@ function renderFrameToCanvas(ctx, frame, options, canvasWidth, canvasHeight, tim
   const hcR = parseInt(hc.slice(1, 3), 16) || 255;
   const hcG = parseInt(hc.slice(3, 5), 16) || 255;
   const hcB = parseInt(hc.slice(5, 7), 16) || 255;
-  const acHex = (options.accentColor || "#ffffff").replace("#", "");
+  const acHex = resolveAccentHex(options.accentColor);
   const acR = parseInt(acHex.substring(0, 2), 16) || 255;
   const acG = parseInt(acHex.substring(2, 4), 16) || 255;
   const acB = parseInt(acHex.substring(4, 6), 16) || 255;
@@ -897,13 +908,13 @@ function renderFrameToCanvas(ctx, frame, options, canvasWidth, canvasHeight, tim
         const py = y * cellH + cellH * 0.5 + hoverOffY;
         let color;
         if (hoverBlend > 0) {
-          const rgb = getCellColorRGB(cell, colorMode, acR, acG, acB);
+          const rgb = getCellColorRGB(cell, colorMode, acR, acG, acB, isInverted);
           const cr = Math.min(255, rgb[0] + (hcR - rgb[0]) * hoverBlend | 0);
           const cg = Math.min(255, rgb[1] + (hcG - rgb[1]) * hoverBlend | 0);
           const cb = Math.min(255, rgb[2] + (hcB - rgb[2]) * hoverBlend | 0);
           color = `rgb(${cr},${cg},${cb})`;
         } else {
-          color = getCellColorStr(cell, colorMode, acR, acG, acB);
+          color = getCellColorStr(cell, colorMode, acR, acG, acB, isInverted);
         }
         const alpha = Math.min(1, cell.a * 0.00392156863 * animMul * (1 + hoverGlow));
         if (alpha !== lastAlpha) {
@@ -979,13 +990,13 @@ function renderFrameToCanvas(ctx, frame, options, canvasWidth, canvasHeight, tim
         const py = y * cellH + cellH * 0.5 + hoverOffY;
         let color;
         if (hoverBlend > 0) {
-          const rgb = getCellColorRGB(cell, colorMode, acR, acG, acB);
+          const rgb = getCellColorRGB(cell, colorMode, acR, acG, acB, isInverted);
           const cr = Math.min(255, rgb[0] + (hcR - rgb[0]) * hoverBlend | 0);
           const cg = Math.min(255, rgb[1] + (hcG - rgb[1]) * hoverBlend | 0);
           const cb = Math.min(255, rgb[2] + (hcB - rgb[2]) * hoverBlend | 0);
           color = `rgb(${cr},${cg},${cb})`;
         } else {
-          color = getCellColorStr(cell, colorMode, acR, acG, acB);
+          color = getCellColorStr(cell, colorMode, acR, acG, acB, isInverted);
         }
         if (useFastRect) {
           const weight = charWeights[cell.char] ?? 0.5;