asciify-engine 1.0.10 → 1.0.11

package/dist/index.cjs

@@ -832,7 +832,7 @@ async function asciifyVideo(source, canvas, { fontSize = 10, style = "classic",
     cancelAnimationFrame(animId);
   };
 }
-var EMBED_CDN_VERSION = "1.0.10";
+var EMBED_CDN_VERSION = "1.0.11";
 function buildEmbedOpts(options, rows, cols, width, height, fps, animated) {
   const o = {
     r: rows,
@@ -999,6 +999,70 @@ function renderWaveBackground(ctx, width, height, time, mousePos = { x: 0.5, y:
     }
   }
 }
+function mountWaveBackground(target, options = {}) {
+  const { opacity = 0.2, className, zIndex = 0, ...renderOpts } = options;
+  const container = typeof target === "string" ? document.querySelector(target) : target;
+  if (!container) {
+    console.warn("[asciify] mountWaveBackground: target not found", target);
+    return { destroy: () => {
+    } };
+  }
+  const prevPosition = container.style.position;
+  if (getComputedStyle(container).position === "static") {
+    container.style.position = "relative";
+  }
+  const canvas = document.createElement("canvas");
+  canvas.style.cssText = [
+    "position:absolute",
+    "inset:0",
+    "width:100%",
+    "height:100%",
+    `opacity:${opacity}`,
+    "pointer-events:none",
+    `z-index:${zIndex}`
+  ].join(";");
+  if (className) canvas.className = className;
+  container.prepend(canvas);
+  const ctx = canvas.getContext("2d");
+  const dpr = window.devicePixelRatio || 1;
+  const mouse = { x: 0.5, y: 0.5 };
+  const smoothMouse = { x: 0.5, y: 0.5 };
+  const resize = () => {
+    const r = container.getBoundingClientRect();
+    canvas.width = r.width * dpr;
+    canvas.height = r.height * dpr;
+    ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
+  };
+  resize();
+  const onMouseMove = (e) => {
+    const r = container.getBoundingClientRect();
+    mouse.x = (e.clientX - r.left) / r.width;
+    mouse.y = (e.clientY - r.top) / r.height;
+  };
+  const ro = new ResizeObserver(resize);
+  ro.observe(container);
+  window.addEventListener("mousemove", onMouseMove);
+  let time = 0;
+  let raf = 0;
+  const tick = () => {
+    smoothMouse.x += (mouse.x - smoothMouse.x) * 0.07;
+    smoothMouse.y += (mouse.y - smoothMouse.y) * 0.07;
+    const r = container.getBoundingClientRect();
+    renderWaveBackground(ctx, r.width, r.height, time, smoothMouse, renderOpts);
+    time += 0.016;
+    raf = requestAnimationFrame(tick);
+  };
+  raf = requestAnimationFrame(tick);
+  return {
+    destroy: () => {
+      cancelAnimationFrame(raf);
+      ro.disconnect();
+      window.removeEventListener("mousemove", onMouseMove);
+      canvas.remove();
+      container.style.position = prevPosition;
+    }
+  };
+}
 
 // src/webgl-engine.ts
 var VERT_SRC = (
@@ -1459,6 +1523,7 @@ exports.generateAnimatedEmbedCode = generateAnimatedEmbedCode;
 exports.generateEmbedCode = generateEmbedCode;
 exports.gifToAsciiFrames = gifToAsciiFrames;
 exports.imageToAsciiFrame = imageToAsciiFrame;
+exports.mountWaveBackground = mountWaveBackground;
 exports.renderFrameToCanvas = renderFrameToCanvas;
 exports.renderWaveBackground = renderWaveBackground;
 exports.tryCreateWebGLRenderer = tryCreateWebGLRenderer;