asciify-engine 1.0.52 → 1.0.54

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

@@ -620,6 +620,34 @@ function resolveInvert(invert) {
   if (invert !== "auto") return invert;
   return typeof window !== "undefined" && !window.matchMedia("(prefers-color-scheme: dark)").matches;
 }
+function cssValueToHex(val) {
+  const hexMatch = val.match(/^#([0-9a-fA-F]{3,6})$/);
+  if (hexMatch) {
+    let h = hexMatch[1];
+    if (h.length === 3) h = h[0] + h[0] + h[1] + h[1] + h[2] + h[2];
+    if (h.length === 6) return h;
+  }
+  const rgbMatch = val.match(/rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)/);
+  if (rgbMatch) {
+    return [rgbMatch[1], rgbMatch[2], rgbMatch[3]].map((n) => parseInt(n).toString(16).padStart(2, "0")).join("");
+  }
+  return null;
+}
+function resolveAccentHex(accentColor) {
+  const v = accentColor || "auto";
+  if (v !== "auto") return v.replace("#", "");
+  if (typeof document !== "undefined") {
+    const rootStyle = getComputedStyle(document.documentElement);
+    for (const prop of ["--accent-color", "--color-accent", "--accent", "--color-primary", "--primary", "--brand-color"]) {
+      const hex = cssValueToHex(rootStyle.getPropertyValue(prop).trim());
+      if (hex) return hex;
+    }
+    const native = cssValueToHex(getComputedStyle(document.body).accentColor ?? "");
+    if (native) return native;
+  }
+  const isDark = typeof window !== "undefined" && window.matchMedia("(prefers-color-scheme: dark)").matches;
+  return isDark ? "faf9f7" : "0d0d0d";
+}
 function imageToAsciiFrame(source, options, targetWidth, targetHeight) {
   const srcWidth = source instanceof HTMLVideoElement ? source.videoWidth : source.width;
   const srcHeight = source instanceof HTMLVideoElement ? source.videoHeight : source.height;
@@ -784,7 +812,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,
@@ -829,7 +857,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;