asciify-engine 1.0.50 → 1.0.51

package/dist/index.d.cts

@@ -52,8 +52,14 @@ interface AsciiOptions {
      * Any CSS colour string. Default: `'#d4ff00'`
      */
     accentColor: string;
-    /** Invert luminance mapping (light pixels → dense chars). Default: `false` */
-    invert: boolean;
+    /**
+     * Invert luminance mapping (light pixels → dense chars). Default: `false`
+     *
+     * Set to `'auto'` to let the engine detect the OS color scheme:
+     * - Light mode → inverts (bright pixel = dark char = visible on white background)
+     * - Dark mode  → normal  (bright pixel = bright char = visible on dark background)
+     */
+    invert: boolean | 'auto';
     /**
      * Render mode.
      * - `'ascii'` — characters drawn as text

package/dist/index.d.ts

@@ -52,8 +52,14 @@ interface AsciiOptions {
      * Any CSS colour string. Default: `'#d4ff00'`
      */
     accentColor: string;
-    /** Invert luminance mapping (light pixels → dense chars). Default: `false` */
-    invert: boolean;
+    /**
+     * Invert luminance mapping (light pixels → dense chars). Default: `false`
+     *
+     * Set to `'auto'` to let the engine detect the OS color scheme:
+     * - Light mode → inverts (bright pixel = dark char = visible on white background)
+     * - Dark mode  → normal  (bright pixel = bright char = visible on dark background)
+     */
+    invert: boolean | 'auto';
     /**
      * Render mode.
      * - `'ascii'` — characters drawn as text

package/dist/index.js

@@ -613,6 +613,10 @@ function renderWaveBackground(ctx, width, height, time, mousePos = { x: 0.5, y:
 }
 
 // src/core/renderer.ts
+function resolveInvert(invert) {
+  if (invert !== "auto") return invert;
+  return typeof window !== "undefined" && !window.matchMedia("(prefers-color-scheme: dark)").matches;
+}
 function imageToAsciiFrame(source, options, targetWidth, targetHeight) {
   const srcWidth = source instanceof HTMLVideoElement ? source.videoWidth : source.width;
   const srcHeight = source instanceof HTMLVideoElement ? source.videoHeight : source.height;
@@ -646,6 +650,7 @@ function imageToAsciiFrame(source, options, targetWidth, targetHeight) {
     normRange = hi > lo ? hi - lo : 255;
   }
   const frame = [];
+  const invertVal = resolveInvert(options.invert);
   const ck = options.chromaKey;
   const ckEnabled = ck != null && ck !== false;
   const ckHeuristicGreen = ck === true;
@@ -685,7 +690,7 @@ function imageToAsciiFrame(source, options, targetWidth, targetHeight) {
       const lum = options.normalize ? (rawLum - normMin) / normRange * 255 : rawLum;
       const adjustedLum = adjustLuminance(lum, options.brightness, options.contrast);
       const ditheredLum = applyDither(adjustedLum, x, y, options.ditherStrength);
-      const char = options.customText ? customTextToChar(ditheredLum, options.customText, x, y, cols, options.invert) : luminanceToChar(ditheredLum, options.charset, options.invert);
+      const char = options.customText ? customTextToChar(ditheredLum, options.customText, x, y, cols, invertVal) : luminanceToChar(ditheredLum, options.charset, invertVal);
       row.push({ char, r, g, b, a });
     }
     frame.push(row);
@@ -844,7 +849,7 @@ function renderFrameToCanvas(ctx, frame, options, canvasWidth, canvasHeight, tim
   const hoverStrength = options.hoverStrength;
   const hoverEffect = options.hoverEffect;
   const hoverRadiusFactor = effectiveHoverRadius;
-  const isInverted = options.invert;
+  const isInverted = resolveInvert(options.invert);
   const colorMode = options.colorMode;
   const TWO_PI = Math.PI * 2;
   const invCols = 1 / cols;