asciify-engine 1.0.15 → 1.0.16

package/dist/index.d.cts

@@ -407,6 +407,30 @@ declare function renderGridBackground(ctx: CanvasRenderingContext2D, width: numb
     x: number;
     y: number;
 }, options?: GridBackgroundOptions): void;
+interface AuroraBackgroundOptions {
+    /** Character grid density. Default 14. */
+    fontSize?: number;
+    /** Character ramp from sparse to dense. Default fine gradient ramp. */
+    chars?: string;
+    /** Base character color. Default theme-aware white/black. */
+    color?: string;
+    /** Accent color for intensity peaks. Default '#d4ff00'. */
+    accentColor?: string;
+    /** Animation speed multiplier. Default 1. */
+    speed?: number;
+    /** Number of wave layers stacked. More = richer interference. Default 5. */
+    layers?: number;
+    /** Wave spread/softness — higher = broader, more diffuse bands. Default 1.2. */
+    softness?: number;
+    /** Mouse distortion radius (0–1). Elegant ripple that follows the cursor. Default 0.2. */
+    mouseRipple?: number;
+    /** Force light mode (dark chars on light bg). Default false. */
+    lightMode?: boolean;
+}
+declare function renderAuroraBackground(ctx: CanvasRenderingContext2D, width: number, height: number, time: number, mousePos?: {
+    x: number;
+    y: number;
+}, options?: AuroraBackgroundOptions): void;
 /**
  * Drop-in helper that mounts an interactive ASCII wave background onto any
  * element. Injects a canvas, wires DPR resize, mouse tracking, and the RAF
@@ -429,7 +453,7 @@ declare function renderGridBackground(ctx: CanvasRenderingContext2D, width: numb
  * useEffect(() => asciiBackground(ref.current).destroy, []);
  * ```
  */
-interface AsciiBackgroundOptions extends WaveBackgroundOptions, RainBackgroundOptions, StarsBackgroundOptions, PulseBackgroundOptions, NoiseBackgroundOptions, GridBackgroundOptions {
+interface AsciiBackgroundOptions extends WaveBackgroundOptions, RainBackgroundOptions, StarsBackgroundOptions, PulseBackgroundOptions, NoiseBackgroundOptions, GridBackgroundOptions, AuroraBackgroundOptions {
     /**
      * Which background to render (default: 'wave').
      * - 'wave'  — interactive ASCII field with vortex, sparkles, breathe
@@ -439,7 +463,7 @@ interface AsciiBackgroundOptions extends WaveBackgroundOptions, RainBackgroundOp
      * - 'noise' — slow-drifting organic fractal noise field
      * - 'grid'  — CRT-style horizontal scan bands with cursor glitch zone
      */
-    type?: 'wave' | 'rain' | 'stars' | 'pulse' | 'noise' | 'grid';
+    type?: 'wave' | 'rain' | 'stars' | 'pulse' | 'noise' | 'grid' | 'aurora';
     /** CSS opacity applied to the canvas element (default: 0.2) */
     opacity?: number;
     /** Extra CSS class names added to the injected canvas */
@@ -485,4 +509,4 @@ interface WebGLRenderer {
  */
 declare function tryCreateWebGLRenderer(canvas: HTMLCanvasElement): WebGLRenderer | null;
 
-export { ART_STYLE_PRESETS, type AnimationStyle, type ArtStyle, type AsciiBackgroundOptions, type AsciiCell, type AsciiFrame, type AsciiOptions, type AsciiResult, type AsciifySimpleOptions, CHARSETS, type CharsetKey, type ColorMode, DEFAULT_OPTIONS, type GridBackgroundOptions, HOVER_PRESETS, type HoverEffect, type HoverPreset, type MountWaveOptions, type NoiseBackgroundOptions, type PulseBackgroundOptions, type RainBackgroundOptions, type RenderMode, type SourceType, type StarsBackgroundOptions, type WaveBackgroundOptions, type WebGLRenderer, asciiBackground, asciify, asciifyGif, asciifyVideo, generateAnimatedEmbedCode, generateEmbedCode, gifToAsciiFrames, imageToAsciiFrame, mountWaveBackground, renderFrameToCanvas, renderGridBackground, renderNoiseBackground, renderPulseBackground, renderRainBackground, renderStarsBackground, renderWaveBackground, tryCreateWebGLRenderer, videoToAsciiFrames };
+export { ART_STYLE_PRESETS, type AnimationStyle, type ArtStyle, type AsciiBackgroundOptions, type AsciiCell, type AsciiFrame, type AsciiOptions, type AsciiResult, type AsciifySimpleOptions, type AuroraBackgroundOptions, CHARSETS, type CharsetKey, type ColorMode, DEFAULT_OPTIONS, type GridBackgroundOptions, HOVER_PRESETS, type HoverEffect, type HoverPreset, type MountWaveOptions, type NoiseBackgroundOptions, type PulseBackgroundOptions, type RainBackgroundOptions, type RenderMode, type SourceType, type StarsBackgroundOptions, type WaveBackgroundOptions, type WebGLRenderer, asciiBackground, asciify, asciifyGif, asciifyVideo, generateAnimatedEmbedCode, generateEmbedCode, gifToAsciiFrames, imageToAsciiFrame, mountWaveBackground, renderAuroraBackground, renderFrameToCanvas, renderGridBackground, renderNoiseBackground, renderPulseBackground, renderRainBackground, renderStarsBackground, renderWaveBackground, tryCreateWebGLRenderer, videoToAsciiFrames };

package/dist/index.d.ts

@@ -407,6 +407,30 @@ declare function renderGridBackground(ctx: CanvasRenderingContext2D, width: numb
     x: number;
     y: number;
 }, options?: GridBackgroundOptions): void;
+interface AuroraBackgroundOptions {
+    /** Character grid density. Default 14. */
+    fontSize?: number;
+    /** Character ramp from sparse to dense. Default fine gradient ramp. */
+    chars?: string;
+    /** Base character color. Default theme-aware white/black. */
+    color?: string;
+    /** Accent color for intensity peaks. Default '#d4ff00'. */
+    accentColor?: string;
+    /** Animation speed multiplier. Default 1. */
+    speed?: number;
+    /** Number of wave layers stacked. More = richer interference. Default 5. */
+    layers?: number;
+    /** Wave spread/softness — higher = broader, more diffuse bands. Default 1.2. */
+    softness?: number;
+    /** Mouse distortion radius (0–1). Elegant ripple that follows the cursor. Default 0.2. */
+    mouseRipple?: number;
+    /** Force light mode (dark chars on light bg). Default false. */
+    lightMode?: boolean;
+}
+declare function renderAuroraBackground(ctx: CanvasRenderingContext2D, width: number, height: number, time: number, mousePos?: {
+    x: number;
+    y: number;
+}, options?: AuroraBackgroundOptions): void;
 /**
  * Drop-in helper that mounts an interactive ASCII wave background onto any
  * element. Injects a canvas, wires DPR resize, mouse tracking, and the RAF
@@ -429,7 +453,7 @@ declare function renderGridBackground(ctx: CanvasRenderingContext2D, width: numb
  * useEffect(() => asciiBackground(ref.current).destroy, []);
  * ```
  */
-interface AsciiBackgroundOptions extends WaveBackgroundOptions, RainBackgroundOptions, StarsBackgroundOptions, PulseBackgroundOptions, NoiseBackgroundOptions, GridBackgroundOptions {
+interface AsciiBackgroundOptions extends WaveBackgroundOptions, RainBackgroundOptions, StarsBackgroundOptions, PulseBackgroundOptions, NoiseBackgroundOptions, GridBackgroundOptions, AuroraBackgroundOptions {
     /**
      * Which background to render (default: 'wave').
      * - 'wave'  — interactive ASCII field with vortex, sparkles, breathe
@@ -439,7 +463,7 @@ interface AsciiBackgroundOptions extends WaveBackgroundOptions, RainBackgroundOp
      * - 'noise' — slow-drifting organic fractal noise field
      * - 'grid'  — CRT-style horizontal scan bands with cursor glitch zone
      */
-    type?: 'wave' | 'rain' | 'stars' | 'pulse' | 'noise' | 'grid';
+    type?: 'wave' | 'rain' | 'stars' | 'pulse' | 'noise' | 'grid' | 'aurora';
     /** CSS opacity applied to the canvas element (default: 0.2) */
     opacity?: number;
     /** Extra CSS class names added to the injected canvas */
@@ -485,4 +509,4 @@ interface WebGLRenderer {
  */
 declare function tryCreateWebGLRenderer(canvas: HTMLCanvasElement): WebGLRenderer | null;
 
-export { ART_STYLE_PRESETS, type AnimationStyle, type ArtStyle, type AsciiBackgroundOptions, type AsciiCell, type AsciiFrame, type AsciiOptions, type AsciiResult, type AsciifySimpleOptions, CHARSETS, type CharsetKey, type ColorMode, DEFAULT_OPTIONS, type GridBackgroundOptions, HOVER_PRESETS, type HoverEffect, type HoverPreset, type MountWaveOptions, type NoiseBackgroundOptions, type PulseBackgroundOptions, type RainBackgroundOptions, type RenderMode, type SourceType, type StarsBackgroundOptions, type WaveBackgroundOptions, type WebGLRenderer, asciiBackground, asciify, asciifyGif, asciifyVideo, generateAnimatedEmbedCode, generateEmbedCode, gifToAsciiFrames, imageToAsciiFrame, mountWaveBackground, renderFrameToCanvas, renderGridBackground, renderNoiseBackground, renderPulseBackground, renderRainBackground, renderStarsBackground, renderWaveBackground, tryCreateWebGLRenderer, videoToAsciiFrames };
+export { ART_STYLE_PRESETS, type AnimationStyle, type ArtStyle, type AsciiBackgroundOptions, type AsciiCell, type AsciiFrame, type AsciiOptions, type AsciiResult, type AsciifySimpleOptions, type AuroraBackgroundOptions, CHARSETS, type CharsetKey, type ColorMode, DEFAULT_OPTIONS, type GridBackgroundOptions, HOVER_PRESETS, type HoverEffect, type HoverPreset, type MountWaveOptions, type NoiseBackgroundOptions, type PulseBackgroundOptions, type RainBackgroundOptions, type RenderMode, type SourceType, type StarsBackgroundOptions, type WaveBackgroundOptions, type WebGLRenderer, asciiBackground, asciify, asciifyGif, asciifyVideo, generateAnimatedEmbedCode, generateEmbedCode, gifToAsciiFrames, imageToAsciiFrame, mountWaveBackground, renderAuroraBackground, renderFrameToCanvas, renderGridBackground, renderNoiseBackground, renderPulseBackground, renderRainBackground, renderStarsBackground, renderWaveBackground, tryCreateWebGLRenderer, videoToAsciiFrames };

package/dist/index.js

@@ -830,7 +830,7 @@ async function asciifyVideo(source, canvas, { fontSize = 10, style = "classic",
     cancelAnimationFrame(animId);
   };
 }
-var EMBED_CDN_VERSION = "1.0.15";
+var EMBED_CDN_VERSION = "1.0.16";
 function buildEmbedOpts(options, rows, cols, width, height, fps, animated) {
   const o = {
     r: rows,
@@ -1326,6 +1326,95 @@ function renderGridBackground(ctx, width, height, time, mousePos = { x: 0.5, y:
     }
   }
 }
+function renderAuroraBackground(ctx, width, height, time, mousePos = { x: 0.5, y: 0.5 }, options = {}) {
+  const {
+    fontSize = 14,
+    chars = " \xB7\u2219\u2022:;+=\u2261\u2263#@",
+    color,
+    accentColor = "#d4ff00",
+    speed = 1,
+    layers = 5,
+    softness = 1.2,
+    mouseRipple = 0.2,
+    lightMode = false
+  } = options;
+  const charW = fontSize * 0.62;
+  const lineH = fontSize * 1.4;
+  const cols = Math.ceil(width / charW);
+  const rows = Math.ceil(height / lineH);
+  ctx.clearRect(0, 0, width, height);
+  ctx.font = `${fontSize}px monospace`;
+  ctx.textBaseline = "top";
+  let cr = 255, cg = 255, cb = 255;
+  if (lightMode) {
+    cr = 0;
+    cg = 0;
+    cb = 0;
+  }
+  if (color) {
+    const p = _parseColor(color);
+    if (p) {
+      cr = p.r;
+      cg = p.g;
+      cb = p.b;
+    }
+  }
+  let acR = 212, acG = 255, acB = 0;
+  const ap = _parseColor(accentColor);
+  if (ap) {
+    acR = ap.r;
+    acG = ap.g;
+    acB = ap.b;
+  }
+  const t = time * speed;
+  const layerParams = [];
+  for (let l = 0; l < layers; l++) {
+    const seed = _hash2(l * 17, l * 31 + 7);
+    const seed2 = _hash2(l * 23 + 5, l * 11);
+    layerParams.push({
+      fx: 0.8 + seed * 2.2,
+      // x spatial frequency
+      fy: 1.2 + seed2 * 1.8,
+      // y spatial frequency
+      phase: seed * Math.PI * 4,
+      // phase offset
+      dt: (0.3 + _hash2(l * 7, l * 13 + 3) * 0.5) * (l % 2 === 0 ? 1 : -1),
+      // drift speed & direction
+      amp: 0.55 + _hash2(l * 29, l * 3) * 0.45
+      // amplitude weight
+    });
+  }
+  for (let row = 0; row < rows; row++) {
+    const ny = row / rows;
+    for (let col = 0; col < cols; col++) {
+      const nx = col / cols;
+      const mdx = nx - mousePos.x;
+      const mdy = ny - mousePos.y;
+      const md = Math.sqrt(mdx * mdx + mdy * mdy);
+      const warp = mouseRipple * Math.exp(-md * md / 0.06);
+      const wx = nx + mdx * warp;
+      const wy = ny + mdy * warp;
+      let sum = 0;
+      let totalAmp = 0;
+      for (let l = 0; l < layers; l++) {
+        const { fx, fy, phase, dt, amp } = layerParams[l];
+        const wave = Math.sin(wx * fx * Math.PI * 2 + t * dt + phase) * Math.cos(wy * fy * Math.PI * 2 + t * dt * 0.7 + phase * 1.3);
+        sum += wave * amp;
+        totalAmp += amp;
+      }
+      const rawVal = sum / totalAmp;
+      const curved = 0.5 + 0.5 * Math.tanh(rawVal * softness * 2.2);
+      if (curved < 0.12) continue;
+      const normalized = (curved - 0.12) / 0.88;
+      const charIdx = Math.min(chars.length - 1, Math.floor(normalized * chars.length));
+      const ch = chars[charIdx];
+      const isAccent = curved > 0.82;
+      const alpha = lightMode ? curved * 0.18 : curved * 0.14;
+      ctx.fillStyle = isAccent ? `rgba(${acR},${acG},${acB},${lightMode ? 0.5 : 0.32})` : `rgba(${cr},${cg},${cb},${alpha})`;
+      ctx.fillText(ch, col * charW, row * lineH);
+    }
+  }
+}
 function _parseColor(c) {
   const hex = c.match(/^#([0-9a-f]{3,8})$/i)?.[1];
   if (hex) {
@@ -1409,6 +1498,11 @@ function asciiBackground(target, options = {}) {
     lightMode: renderOpts.lightMode !== void 0 ? renderOpts.lightMode : isLight(),
     color: color ?? renderOpts.color
   });
+  const buildAuroraOpts = () => ({
+    ...renderOpts,
+    lightMode: renderOpts.lightMode !== void 0 ? renderOpts.lightMode : isLight(),
+    color: color ?? renderOpts.color
+  });
   const optsRef = { current: buildWaveOpts() };
   const rebuildOpts = () => {
     if (type === "rain") optsRef.current = buildRainOpts();
@@ -1416,6 +1510,7 @@ function asciiBackground(target, options = {}) {
     else if (type === "pulse") optsRef.current = buildPulseOpts();
     else if (type === "noise") optsRef.current = buildNoiseOpts();
     else if (type === "grid") optsRef.current = buildGridOpts();
+    else if (type === "aurora") optsRef.current = buildAuroraOpts();
     else optsRef.current = buildWaveOpts();
   };
   rebuildOpts();
@@ -1454,6 +1549,8 @@ function asciiBackground(target, options = {}) {
       renderNoiseBackground(ctx, r.width, r.height, time, smoothMouse, optsRef.current);
     } else if (type === "grid") {
       renderGridBackground(ctx, r.width, r.height, time, smoothMouse, optsRef.current);
+    } else if (type === "aurora") {
+      renderAuroraBackground(ctx, r.width, r.height, time, smoothMouse, optsRef.current);
     } else {
       renderWaveBackground(ctx, r.width, r.height, time, smoothMouse, optsRef.current);
     }
@@ -1922,6 +2019,6 @@ function tryCreateWebGLRenderer(canvas) {
   }
 }
 
-export { ART_STYLE_PRESETS, CHARSETS, DEFAULT_OPTIONS, HOVER_PRESETS, asciiBackground, asciify, asciifyGif, asciifyVideo, generateAnimatedEmbedCode, generateEmbedCode, gifToAsciiFrames, imageToAsciiFrame, mountWaveBackground, renderFrameToCanvas, renderGridBackground, renderNoiseBackground, renderPulseBackground, renderRainBackground, renderStarsBackground, renderWaveBackground, tryCreateWebGLRenderer, videoToAsciiFrames };
+export { ART_STYLE_PRESETS, CHARSETS, DEFAULT_OPTIONS, HOVER_PRESETS, asciiBackground, asciify, asciifyGif, asciifyVideo, generateAnimatedEmbedCode, generateEmbedCode, gifToAsciiFrames, imageToAsciiFrame, mountWaveBackground, renderAuroraBackground, renderFrameToCanvas, renderGridBackground, renderNoiseBackground, renderPulseBackground, renderRainBackground, renderStarsBackground, renderWaveBackground, tryCreateWebGLRenderer, videoToAsciiFrames };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map