asciify-engine 1.0.46 → 1.0.48

package/dist/index.d.cts

@@ -135,14 +135,28 @@ interface AsciiOptions {
      * are keyed out: their character becomes a space and alpha is set to 0,
      * letting the canvas background show through.
      *
-     * Accepts `{ r, g, b }`, a CSS colour string (`'#00ff00'`, `'blue'`, …),
-     * or `null` to disable. Default: `null`
+     * - `true` — **smart green screen**: heuristic detection (`g > r*1.4 && g > b*1.4`)
+     *   catches every shade of green screen (lime, broadcast, chroma green) with no
+     *   config. Works on virtually all studio/streaming footage.
+     * - `'blue-screen'` — **smart blue screen**: same heuristic for blue.
+     * - `{ r, g, b }` or CSS colour string — custom key colour + `chromaKeyTolerance`
+     * - `null` / `false` — disabled (default)
+     *
+     * @example
+     * // Standard green screen — zero config:
+     * options: { chromaKey: true }
+     *
+     * // Blue screen — zero config:
+     * options: { chromaKey: 'blue-screen' }
+     *
+     * // Custom CSS colour:
+     * options: { chromaKey: '#00b140', chromaKeyTolerance: 70 }
      */
     chromaKey: {
         r: number;
         g: number;
         b: number;
-    } | string | null;
+    } | string | boolean | null;
     /**
      * Euclidean RGB tolerance radius for chroma-key detection.
      * `0` = exact match only, `441` ≈ key out everything.

package/dist/index.d.ts

@@ -135,14 +135,28 @@ interface AsciiOptions {
      * are keyed out: their character becomes a space and alpha is set to 0,
      * letting the canvas background show through.
      *
-     * Accepts `{ r, g, b }`, a CSS colour string (`'#00ff00'`, `'blue'`, …),
-     * or `null` to disable. Default: `null`
+     * - `true` — **smart green screen**: heuristic detection (`g > r*1.4 && g > b*1.4`)
+     *   catches every shade of green screen (lime, broadcast, chroma green) with no
+     *   config. Works on virtually all studio/streaming footage.
+     * - `'blue-screen'` — **smart blue screen**: same heuristic for blue.
+     * - `{ r, g, b }` or CSS colour string — custom key colour + `chromaKeyTolerance`
+     * - `null` / `false` — disabled (default)
+     *
+     * @example
+     * // Standard green screen — zero config:
+     * options: { chromaKey: true }
+     *
+     * // Blue screen — zero config:
+     * options: { chromaKey: 'blue-screen' }
+     *
+     * // Custom CSS colour:
+     * options: { chromaKey: '#00b140', chromaKeyTolerance: 70 }
      */
     chromaKey: {
         r: number;
         g: number;
         b: number;
-    } | string | null;
+    } | string | boolean | null;
     /**
      * Euclidean RGB tolerance radius for chroma-key detection.
      * `0` = exact match only, `441` ≈ key out everything.

package/dist/index.js

@@ -646,10 +646,14 @@ function imageToAsciiFrame(source, options, targetWidth, targetHeight) {
     normRange = hi > lo ? hi - lo : 255;
   }
   const frame = [];
+  const ck = options.chromaKey;
+  const ckEnabled = ck != null && ck !== false;
+  const ckHeuristicGreen = ck === true;
+  const ckHeuristicBlue = ck === "blue-screen";
   let ckRGB = null;
   let ckTolSq = 0;
-  if (options.chromaKey != null) {
-    ckRGB = parseChromaKeyColor(options.chromaKey);
+  if (ckEnabled && !ckHeuristicGreen && !ckHeuristicBlue) {
+    ckRGB = parseChromaKeyColor(ck);
     ckTolSq = (options.chromaKeyTolerance ?? 60) ** 2;
   }
   for (let y = 0; y < rows; y++) {
@@ -660,11 +664,19 @@ function imageToAsciiFrame(source, options, targetWidth, targetHeight) {
       const g = pixels[i + 1];
       const b = pixels[i + 2];
       const a = pixels[i + 3];
-      if (ckRGB !== null) {
-        const dr = r - ckRGB.r;
-        const dg = g - ckRGB.g;
-        const db = b - ckRGB.b;
-        if (dr * dr + dg * dg + db * db <= ckTolSq) {
+      if (ckEnabled) {
+        let keyed = false;
+        if (ckHeuristicGreen) {
+          keyed = g > r * 1.4 && g > b * 1.4 && g > 80;
+        } else if (ckHeuristicBlue) {
+          keyed = b > r * 1.4 && b > g * 1.4 && b > 80;
+        } else if (ckRGB !== null) {
+          const dr = r - ckRGB.r;
+          const dg = g - ckRGB.g;
+          const db = b - ckRGB.b;
+          keyed = dr * dr + dg * dg + db * db <= ckTolSq;
+        }
+        if (keyed) {
           row.push({ char: " ", r: 0, g: 0, b: 0, a: 0 });
           continue;
         }