@firecms/neat 0.6.0 → 0.7.1

package/dist/NeatGradient.js

@@ -1,10 +1,9 @@
-import * as THREE from "three";
+import { buildColorFunctions, buildNoise, buildVertUniforms, buildFragUniforms, fragmentShaderSource, vertexShaderSource } from "./shaders";
+import { generatePlaneGeometry, OrthographicCamera, updateCamera, Matrix4 } from "./math";
 console.info("%c🌈 Neat Gradients%c\n\nLicensed under MIT + The Commons Clause.\nFree for personal and commercial use.\nSelling this software or its derivatives is strictly prohibited.\nhttps://neat.firecms.co", "font-weight: bold; font-size: 14px; color: #FF5772;", "color: inherit;");
 const PLANE_WIDTH = 50;
 const PLANE_HEIGHT = 80;
-const WIREFRAME = true;
 const COLORS_COUNT = 6;
-const clock = new THREE.Clock();
 const LINK_ID = generateRandomString();
 export class NeatGradient {
     _ref;
@@ -26,6 +25,7 @@ export class NeatGradient {
     _colors = [];
     _wireframe = false;
     _backgroundColor = "#FFFFFF";
+    _backgroundColorRgb = [1, 1, 1];
     _backgroundAlpha = 1.0;
     // Flow field properties
     _flowDistortionA = 0;
@@ -33,18 +33,7 @@ export class NeatGradient {
     _flowScale = 1.0;
     _flowEase = 0.0;
     _flowEnabled = true;
-    // Mouse interaction properties
-    _mouseDistortionStrength = 0.0;
-    _mouseDistortionRadius = 0.25;
-    _mouseDecayRate = 0.96;
-    _mouseDarken = 0.0;
-    _mouse = new THREE.Vector2(-1000, -1000);
-    _mouseFBO = null;
-    _sceneMouse = null;
-    _cameraMouse = null;
-    _mouseObjects = [];
-    _currentBrush = 0;
-    _mouseBrushBaseScale = 1;
+    glState;
     // Texture generation properties
     _enableProceduralTexture = false;
     _textureVoidLikelihood = 0.45;
@@ -62,36 +51,29 @@ export class NeatGradient {
     _textureShapeSquiggles = 10;
     requestRef = -1;
     sizeObserver;
-    sceneState;
-    // Optimization: Cache uniforms to avoid lookups and object creation in render loop
-    _cachedUniforms = null;
+    _initialized = false;
     _linkElement = null;
+    _cachedColorRgb = [];
     _yOffset = 0;
     _yOffsetWaveMultiplier = 0.004;
     _yOffsetColorMultiplier = 0.004;
     _yOffsetFlowMultiplier = 0.004;
-    // For saving/restoring clear color
-    _tempClearColor = new THREE.Color();
     // Performance optimizations
     _resizeTimeoutId = null;
     _textureNeedsUpdate = false;
-    _lastColorUpdate = 0;
     _linkCheckCounter = 0;
-    _mouseUpdateScheduled = false;
-    _pendingMousePosition = null;
-    _colorsChanged = true; // Track if colors need update
+    _colorsChanged = true;
+    _uniformsDirty = true;
+    _textureDirty = true;
     constructor(config) {
         const { ref, speed = 4, horizontalPressure = 3, verticalPressure = 3, waveFrequencyX = 5, waveFrequencyY = 5, waveAmplitude = 3, colors, highlights = 4, shadows = 4, colorSaturation = 0, colorBrightness = 1, colorBlending = 5, grainScale = 2, grainIntensity = 0.55, grainSparsity = 0.0, grainSpeed = 0.1, wireframe = false, backgroundColor = "#FFFFFF", backgroundAlpha = 1.0, resolution = 1, seed, yOffset = 0, yOffsetWaveMultiplier = 4, yOffsetColorMultiplier = 4, yOffsetFlowMultiplier = 4, 
         // Flow field parameters
         flowDistortionA = 0, flowDistortionB = 0, flowScale = 1.0, flowEase = 0.0, flowEnabled = true, 
-        // Mouse interaction
-        mouseDistortionStrength = 0.0, mouseDistortionRadius = 0.25, mouseDecayRate = 0.96, mouseDarken = 0.0, 
         // Texture generation
         enableProceduralTexture = false, textureVoidLikelihood = 0.45, textureVoidWidthMin = 200, textureVoidWidthMax = 486, textureBandDensity = 2.15, textureColorBlending = 0.01, textureSeed = 333, textureEase = 0.5, proceduralBackgroundColor = "#000000", textureShapeTriangles = 20, textureShapeCircles = 15, textureShapeBars = 15, textureShapeSquiggles = 10, } = config;
         this._ref = ref;
         this.destroy = this.destroy.bind(this);
         this._initScene = this._initScene.bind(this);
-        this._buildMaterial = this._buildMaterial.bind(this);
         this.speed = speed;
         this.horizontalPressure = horizontalPressure;
         this.verticalPressure = verticalPressure;
@@ -121,11 +103,6 @@ export class NeatGradient {
         this.flowScale = flowScale;
         this.flowEase = flowEase;
         this.flowEnabled = flowEnabled;
-        // Mouse interaction
-        this.mouseDistortionStrength = mouseDistortionStrength;
-        this.mouseDistortionRadius = mouseDistortionRadius;
-        this.mouseDecayRate = mouseDecayRate;
-        this.mouseDarken = mouseDarken;
         // Texture generation
         this.enableProceduralTexture = enableProceduralTexture;
         this.textureVoidLikelihood = textureVoidLikelihood;
@@ -140,14 +117,12 @@ export class NeatGradient {
         this._textureShapeCircles = textureShapeCircles;
         this._textureShapeBars = textureShapeBars;
         this._textureShapeSquiggles = textureShapeSquiggles;
-        // FIX 1: Setup mouse resources BEFORE building the material/scene
-        // This ensures u_mouse_texture isn't null during material compilation
-        this._setupMouseInteraction();
-        this.sceneState = this._initScene(resolution);
+        this.glState = this._initScene(resolution);
         injectSEO();
         let tick = seed !== undefined ? seed : getElapsedSecondsInLastHour();
+        let lastTime = performance.now();
         const render = () => {
-            const { renderer, camera, scene } = this.sceneState;
+            const { gl, program, locations, indexCount, indexType } = this.glState;
             // Optimization: check if cached link is still valid in DOM less frequently
             this._linkCheckCounter++;
             if (this._linkCheckCounter >= 300) { // Check every ~5 seconds at 60fps
@@ -156,134 +131,101 @@ export class NeatGradient {
                     this._linkElement = addNeatLink(ref);
                 }
             }
-            // Update Uniforms efficiently without creating new objects
-            if (this._cachedUniforms) {
-                const u = this._cachedUniforms;
-                tick += clock.getDelta() * this._speed;
-                u.u_time.value = tick;
-                u.u_resolution.value.set(this._ref.width, this._ref.height);
-                u.u_color_pressure.value.set(this._horizontalPressure, this._verticalPressure);
-                // Directly assign simple values
-                u.u_wave_frequency_x.value = this._waveFrequencyX;
-                u.u_wave_frequency_y.value = this._waveFrequencyY;
-                u.u_wave_amplitude.value = this._waveAmplitude;
-                u.u_color_blending.value = this._colorBlending;
-                u.u_shadows.value = this._shadows;
-                u.u_highlights.value = this._highlights;
-                u.u_saturation.value = this._saturation;
-                u.u_brightness.value = this._brightness;
-                u.u_grain_intensity.value = this._grainIntensity;
-                u.u_grain_sparsity.value = this._grainSparsity;
-                u.u_grain_speed.value = this._grainSpeed;
-                u.u_grain_scale.value = this._grainScale;
-                u.u_y_offset.value = this._yOffset;
-                u.u_y_offset_wave_multiplier.value = this._yOffsetWaveMultiplier;
-                u.u_y_offset_color_multiplier.value = this._yOffsetColorMultiplier;
-                u.u_y_offset_flow_multiplier.value = this._yOffsetFlowMultiplier;
-                u.u_flow_distortion_a.value = this._flowDistortionA;
-                u.u_flow_distortion_b.value = this._flowDistortionB;
-                u.u_flow_scale.value = this._flowScale;
-                u.u_flow_ease.value = this._flowEase;
-                u.u_flow_enabled.value = this._flowEnabled ? 1.0 : 0.0;
-                u.u_mouse_distortion_strength.value = this._mouseDistortionStrength;
-                u.u_mouse_distortion_radius.value = this._mouseDistortionRadius;
-                u.u_mouse_darken.value = this._mouseDarken;
-                u.u_enable_procedural_texture.value = this._enableProceduralTexture ? 1.0 : 0.0;
+            if (this._initialized) {
+                const timeNow = performance.now();
+                tick += ((timeNow - lastTime) / 1000) * this._speed;
+                lastTime = timeNow;
+                gl.useProgram(program);
+                gl.uniform1f(locations.uniforms['u_time'], tick);
+                // Only upload static uniforms when they've been modified
+                if (this._uniformsDirty) {
+                    gl.uniform2f(locations.uniforms['u_resolution'], this._ref.clientWidth, this._ref.clientHeight);
+                    gl.uniform2f(locations.uniforms['u_color_pressure'], this._horizontalPressure, this._verticalPressure);
+                    gl.uniform1f(locations.uniforms['u_wave_frequency_x'], this._waveFrequencyX);
+                    gl.uniform1f(locations.uniforms['u_wave_frequency_y'], this._waveFrequencyY);
+                    gl.uniform1f(locations.uniforms['u_wave_amplitude'], this._waveAmplitude);
+                    gl.uniform1f(locations.uniforms['u_color_blending'], this._colorBlending);
+                    gl.uniform1f(locations.uniforms['u_shadows'], this._shadows);
+                    gl.uniform1f(locations.uniforms['u_highlights'], this._highlights);
+                    gl.uniform1f(locations.uniforms['u_saturation'], this._saturation);
+                    gl.uniform1f(locations.uniforms['u_brightness'], this._brightness);
+                    gl.uniform1f(locations.uniforms['u_grain_intensity'], this._grainIntensity);
+                    gl.uniform1f(locations.uniforms['u_grain_sparsity'], this._grainSparsity);
+                    gl.uniform1f(locations.uniforms['u_grain_speed'], this._grainSpeed);
+                    gl.uniform1f(locations.uniforms['u_grain_scale'], this._grainScale);
+                    gl.uniform1f(locations.uniforms['u_y_offset'], this._yOffset);
+                    gl.uniform1f(locations.uniforms['u_y_offset_wave_multiplier'], this._yOffsetWaveMultiplier);
+                    gl.uniform1f(locations.uniforms['u_y_offset_color_multiplier'], this._yOffsetColorMultiplier);
+                    gl.uniform1f(locations.uniforms['u_y_offset_flow_multiplier'], this._yOffsetFlowMultiplier);
+                    gl.uniform1f(locations.uniforms['u_flow_distortion_a'], this._flowDistortionA);
+                    gl.uniform1f(locations.uniforms['u_flow_distortion_b'], this._flowDistortionB);
+                    gl.uniform1f(locations.uniforms['u_flow_scale'], this._flowScale);
+                    gl.uniform1f(locations.uniforms['u_flow_ease'], this._flowEase);
+                    gl.uniform1f(locations.uniforms['u_flow_enabled'], this._flowEnabled ? 1.0 : 0.0);
+                    gl.uniform1f(locations.uniforms['u_enable_procedural_texture'], this._enableProceduralTexture ? 1.0 : 0.0);
+                    gl.uniform1f(locations.uniforms['u_texture_ease'], this._textureEase);
+                    this._uniformsDirty = false;
+                }
                 // Only regenerate procedural texture when needed
                 if (this._textureNeedsUpdate && this._enableProceduralTexture) {
                     if (this._proceduralTexture) {
-                        this._proceduralTexture.dispose();
+                        gl.deleteTexture(this._proceduralTexture);
                     }
-                    this._proceduralTexture = this._createProceduralTexture();
+                    this._proceduralTexture = this._createProceduralTexture(gl);
                     this._textureNeedsUpdate = false;
+                    this._textureDirty = true;
+                }
+                // Procedural texture binding — only when texture changes
+                if (this._textureDirty && this._proceduralTexture) {
+                    gl.activeTexture(gl.TEXTURE1);
+                    gl.bindTexture(gl.TEXTURE_2D, this._proceduralTexture);
+                    gl.uniform1i(locations.uniforms['u_procedural_texture'], 1);
+                    this._textureDirty = false;
                 }
-                u.u_procedural_texture.value = this._proceduralTexture;
-                u.u_texture_ease.value = this._textureEase;
-                // Wireframe is a material property and must update every frame to avoid artifacts
-                // @ts-ignore - access material safely
-                this.sceneState.meshes[0].material.wireframe = this._wireframe;
-                // Optimized Color Update: Update immediately on change, or throttle to 10 times per second
-                const now = Date.now();
-                const shouldUpdate = this._colorsChanged || (now - this._lastColorUpdate > 100);
-                if (shouldUpdate) {
-                    this._lastColorUpdate = now;
+                // Color update — only when colors have changed
+                if (this._colorsChanged) {
                     this._colorsChanged = false;
-                    const shaderColors = u.u_colors.value;
                     for (let i = 0; i < COLORS_COUNT; i++) {
                         if (i < this._colors.length) {
                             const c = this._colors[i];
-                            shaderColors[i].is_active = c.enabled ? 1.0 : 0.0;
-                            shaderColors[i].color.setStyle(c.color, "");
-                            shaderColors[i].influence = c.influence || 0;
+                            const rgb = this._cachedColorRgb[i] || [0, 0, 0];
+                            gl.uniform1f(locations.uniforms[`u_colors[${i}].is_active`], c.enabled ? 1.0 : 0.0);
+                            gl.uniform3fv(locations.uniforms[`u_colors[${i}].color`], rgb);
+                            gl.uniform1f(locations.uniforms[`u_colors[${i}].influence`], c.influence || 0);
                         }
                         else {
-                            shaderColors[i].is_active = 0.0;
+                            gl.uniform1f(locations.uniforms[`u_colors[${i}].is_active`], 0.0);
                         }
                     }
-                    u.u_colors_count.value = COLORS_COUNT;
+                    gl.uniform1i(locations.uniforms['u_colors_count'], COLORS_COUNT);
                 }
             }
-            // Render mouse interaction to FBO - optimize by only rendering when needed
-            if (this._mouseFBO && this._sceneMouse && this._cameraMouse && this._mouseDistortionStrength > 0) {
-                let hasActiveBrushes = false;
-                // Update mouse objects - decay rate controls how fast trails fade
-                for (let i = 0; i < this._mouseObjects.length; i++) {
-                    const obj = this._mouseObjects[i];
-                    if (obj.mesh.visible) {
-                        hasActiveBrushes = true;
-                        obj.mesh.rotation.z += 0.01;
-                        if (obj.mesh.material instanceof THREE.MeshBasicMaterial) {
-                            // Decay only affects opacity
-                            obj.mesh.material.opacity *= this._mouseDecayRate;
-                            if (obj.mesh.material.opacity < 0.01) {
-                                obj.mesh.visible = false;
-                            }
-                        }
-                    }
-                }
-                // Only render FBO if there are active brushes
-                if (hasActiveBrushes) {
-                    // Store current clear color (likely the main background color)
-                    renderer.getClearColor(this._tempClearColor);
-                    const oldClearAlpha = renderer.getClearAlpha();
-                    // Set clear color to Black/Transparent for the FBO.
-                    renderer.setClearColor(0x000000, 0.0);
-                    renderer.setRenderTarget(this._mouseFBO);
-                    renderer.clear();
-                    renderer.render(this._sceneMouse, this._cameraMouse);
-                    renderer.setRenderTarget(null);
-                    // Restore main background color for the actual scene render
-                    renderer.setClearColor(this._tempClearColor, oldClearAlpha);
-                    // Update mouse texture uniform
-                    if (this._cachedUniforms) {
-                        this._cachedUniforms.u_mouse_texture.value = this._mouseFBO.texture;
-                    }
-                }
+            // Draw scene
+            gl.clearColor(this._backgroundColorRgb[0], this._backgroundColorRgb[1], this._backgroundColorRgb[2], this._backgroundAlpha);
+            gl.clear(gl.COLOR_BUFFER_BIT | gl.DEPTH_BUFFER_BIT);
+            if (this._wireframe) {
+                gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, this.glState.buffers.wireframeIndex);
+                gl.drawElements(gl.LINES, this.glState.wireframeIndexCount, indexType, 0);
+                gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, this.glState.buffers.index);
+            }
+            else {
+                gl.drawElements(gl.TRIANGLES, indexCount, indexType, 0);
             }
-            // Ensure we set the clear color for the main scene explicitly before rendering
-            renderer.setClearColor(this._backgroundColor, this._backgroundAlpha);
-            renderer.render(scene, camera);
             this.requestRef = requestAnimationFrame(render);
         };
         const setSize = () => {
-            const { renderer } = this.sceneState;
-            const canvas = renderer.domElement;
-            const width = canvas.clientWidth;
-            const height = canvas.clientHeight;
-            this.sceneState.renderer.setSize(width, height, false);
-            updateCamera(this.sceneState.camera, width, height);
-            // FIX 3: Update Mouse FBO and Camera on resize
-            // If we don't do this, mouse coordinates map incorrectly after a resize
-            if (this._mouseFBO && this._cameraMouse) {
-                const fSize = height / 2;
-                const aspect = width / height;
-                this._mouseFBO.setSize(width / 2, height / 2);
-                this._cameraMouse.left = -fSize * aspect;
-                this._cameraMouse.right = fSize * aspect;
-                this._cameraMouse.top = fSize;
-                this._cameraMouse.bottom = -fSize;
-                this._cameraMouse.updateProjectionMatrix();
-            }
+            const { gl, camera } = this.glState;
+            const width = this._ref.clientWidth;
+            const height = this._ref.clientHeight;
+            // Handle high DPI displays properly without scaling buffer resolution, matching client width
+            this._ref.width = width;
+            this._ref.height = height;
+            gl.viewport(0, 0, width, height);
+            updateCamera(camera, width, height);
+            // Recompute projection matrix on resize
+            const projLoc = gl.getUniformLocation(this.glState.program, "projectionMatrix");
+            gl.useProgram(this.glState.program);
+            gl.uniformMatrix4fv(projLoc, false, camera.projectionMatrix.elements);
         };
         // Debounce resize to prevent excessive operations
         this.sizeObserver = new ResizeObserver(() => {
@@ -299,197 +241,220 @@ export class NeatGradient {
         render();
     }
     destroy() {
-        if (this) {
-            cancelAnimationFrame(this.requestRef);
-            this.sizeObserver.disconnect();
-            // Clear resize timeout
-            if (this._resizeTimeoutId !== null) {
-                clearTimeout(this._resizeTimeoutId);
-                this._resizeTimeoutId = null;
-            }
-            // Cleanup WebGL resources
-            if (this.sceneState) {
-                this.sceneState.renderer.dispose();
-                this.sceneState.meshes.forEach(m => {
-                    m.geometry.dispose();
-                    if (Array.isArray(m.material))
-                        m.material.forEach(mat => mat.dispose());
-                    else
-                        m.material.dispose();
-                });
-            }
-            if (this._mouseFBO)
-                this._mouseFBO.dispose();
-            if (this._proceduralTexture)
-                this._proceduralTexture.dispose();
+        cancelAnimationFrame(this.requestRef);
+        this.sizeObserver.disconnect();
+        // Clear resize timeout
+        if (this._resizeTimeoutId !== null) {
+            clearTimeout(this._resizeTimeoutId);
+            this._resizeTimeoutId = null;
+        }
+        // Remove NEAT link
+        if (this._linkElement && this._linkElement.parentElement) {
+            this._linkElement.parentElement.removeChild(this._linkElement);
+            this._linkElement = null;
+        }
+        // Cleanup WebGL resources
+        if (this.glState) {
+            const gl = this.glState.gl;
+            gl.deleteProgram(this.glState.program);
+            gl.deleteBuffer(this.glState.buffers.position);
+            gl.deleteBuffer(this.glState.buffers.normal);
+            gl.deleteBuffer(this.glState.buffers.uv);
+            gl.deleteBuffer(this.glState.buffers.index);
+            gl.deleteBuffer(this.glState.buffers.wireframeIndex);
+        }
+        if (this._proceduralTexture && this.glState) {
+            this.glState.gl.deleteTexture(this._proceduralTexture);
         }
     }
     downloadAsPNG(filename = "neat.png") {
-        console.log("Downloading as PNG", this._ref);
         const dataURL = this._ref.toDataURL("image/png");
-        console.log("data", dataURL);
         downloadURI(dataURL, filename);
     }
     set speed(speed) {
+        this._uniformsDirty = true;
         this._speed = speed / 20;
     }
     set horizontalPressure(horizontalPressure) {
+        this._uniformsDirty = true;
         this._horizontalPressure = horizontalPressure / 4;
     }
     set verticalPressure(verticalPressure) {
+        this._uniformsDirty = true;
         this._verticalPressure = verticalPressure / 4;
     }
     set waveFrequencyX(waveFrequencyX) {
+        this._uniformsDirty = true;
         this._waveFrequencyX = waveFrequencyX * 0.04;
     }
     set waveFrequencyY(waveFrequencyY) {
+        this._uniformsDirty = true;
         this._waveFrequencyY = waveFrequencyY * 0.04;
     }
     set waveAmplitude(waveAmplitude) {
+        this._uniformsDirty = true;
         this._waveAmplitude = waveAmplitude * .75;
     }
     set colors(colors) {
+        this._uniformsDirty = true;
         this._colors = colors;
-        this._colorsChanged = true; // Flag for immediate update
+        this._cachedColorRgb = colors.map(c => this._hexToRgb(c.color));
+        this._colorsChanged = true;
     }
     set highlights(highlights) {
+        this._uniformsDirty = true;
         this._highlights = highlights / 100;
     }
     set shadows(shadows) {
+        this._uniformsDirty = true;
         this._shadows = shadows / 100;
     }
     set colorSaturation(colorSaturation) {
+        this._uniformsDirty = true;
         this._saturation = colorSaturation / 10;
     }
     set colorBrightness(colorBrightness) {
+        this._uniformsDirty = true;
         this._brightness = colorBrightness;
     }
     set colorBlending(colorBlending) {
+        this._uniformsDirty = true;
         this._colorBlending = colorBlending / 10;
     }
     set grainScale(grainScale) {
+        this._uniformsDirty = true;
         this._grainScale = grainScale == 0 ? 1 : grainScale;
     }
     set grainIntensity(grainIntensity) {
+        this._uniformsDirty = true;
         this._grainIntensity = grainIntensity;
     }
     set grainSparsity(grainSparsity) {
+        this._uniformsDirty = true;
         this._grainSparsity = grainSparsity;
     }
     set grainSpeed(grainSpeed) {
+        this._uniformsDirty = true;
         this._grainSpeed = grainSpeed;
     }
     set wireframe(wireframe) {
+        this._uniformsDirty = true;
         this._wireframe = wireframe;
     }
     set resolution(resolution) {
-        this.sceneState = this._initScene(resolution);
+        this._uniformsDirty = true;
+        if (this.glState) {
+            const gl = this.glState.gl;
+            gl.deleteProgram(this.glState.program);
+            gl.deleteBuffer(this.glState.buffers.position);
+            gl.deleteBuffer(this.glState.buffers.normal);
+            gl.deleteBuffer(this.glState.buffers.uv);
+            gl.deleteBuffer(this.glState.buffers.index);
+            gl.deleteBuffer(this.glState.buffers.wireframeIndex);
+        }
+        this.glState = this._initScene(resolution);
     }
     set backgroundColor(backgroundColor) {
+        this._uniformsDirty = true;
         this._backgroundColor = backgroundColor;
+        this._backgroundColorRgb = this._hexToRgb(backgroundColor);
     }
     set backgroundAlpha(backgroundAlpha) {
+        this._uniformsDirty = true;
         this._backgroundAlpha = backgroundAlpha;
     }
     set yOffset(yOffset) {
+        this._uniformsDirty = true;
         this._yOffset = yOffset;
     }
     get yOffsetWaveMultiplier() {
         return this._yOffsetWaveMultiplier * 1000;
     }
     set yOffsetWaveMultiplier(value) {
+        this._uniformsDirty = true;
         this._yOffsetWaveMultiplier = value / 1000;
     }
     get yOffsetColorMultiplier() {
         return this._yOffsetColorMultiplier * 1000;
     }
     set yOffsetColorMultiplier(value) {
+        this._uniformsDirty = true;
         this._yOffsetColorMultiplier = value / 1000;
     }
     get yOffsetFlowMultiplier() {
         return this._yOffsetFlowMultiplier * 1000;
     }
     set yOffsetFlowMultiplier(value) {
+        this._uniformsDirty = true;
         this._yOffsetFlowMultiplier = value / 1000;
     }
     set flowDistortionA(value) {
+        this._uniformsDirty = true;
         this._flowDistortionA = value;
     }
     set flowDistortionB(value) {
+        this._uniformsDirty = true;
         this._flowDistortionB = value;
     }
     set flowScale(value) {
+        this._uniformsDirty = true;
         this._flowScale = value;
     }
     set flowEase(value) {
+        this._uniformsDirty = true;
         this._flowEase = value;
     }
     set flowEnabled(value) {
+        this._uniformsDirty = true;
         this._flowEnabled = value;
     }
     get flowEnabled() {
         return this._flowEnabled;
     }
-    set mouseDistortionStrength(value) {
-        this._mouseDistortionStrength = Math.max(0, value);
-    }
-    set mouseDistortionRadius(value) {
-        // Clamp to a sane range in UV space
-        this._mouseDistortionRadius = Math.max(0.01, Math.min(value, 1.0));
-        // Update brush scale when radius changes
-        this._updateBrushScale();
-    }
-    _updateBrushScale() {
-        if (!this._mouseObjects || this._mouseObjects.length === 0)
-            return;
-        // Radius directly controls the brush scale
-        // Base geometry is 200px, so radius 0.25 = 50px, radius 1.0 = 200px
-        this._mouseBrushBaseScale = this._mouseDistortionRadius;
-    }
-    set mouseDecayRate(value) {
-        // Clamp between 0.9 (slow decay, more wobble) and 0.99 (fast decay, less wobble)
-        this._mouseDecayRate = Math.max(0.9, Math.min(value, 0.99));
-    }
-    set mouseDarken(value) {
-        this._mouseDarken = value;
-    }
     set enableProceduralTexture(value) {
+        this._uniformsDirty = true;
         this._enableProceduralTexture = value;
         if (value && !this._proceduralTexture) {
             this._textureNeedsUpdate = true;
         }
     }
     set textureVoidLikelihood(value) {
+        this._uniformsDirty = true;
         this._textureVoidLikelihood = value;
         if (this._enableProceduralTexture) {
             this._textureNeedsUpdate = true;
         }
     }
     set textureVoidWidthMin(value) {
+        this._uniformsDirty = true;
         this._textureVoidWidthMin = value;
         if (this._enableProceduralTexture) {
             this._textureNeedsUpdate = true;
         }
     }
     set textureVoidWidthMax(value) {
+        this._uniformsDirty = true;
         this._textureVoidWidthMax = value;
         if (this._enableProceduralTexture) {
             this._textureNeedsUpdate = true;
         }
     }
     set textureBandDensity(value) {
+        this._uniformsDirty = true;
         this._textureBandDensity = value;
         if (this._enableProceduralTexture) {
             this._textureNeedsUpdate = true;
         }
     }
     set textureColorBlending(value) {
+        this._uniformsDirty = true;
         this._textureColorBlending = value;
         if (this._enableProceduralTexture) {
             this._textureNeedsUpdate = true;
         }
     }
     set textureSeed(value) {
+        this._uniformsDirty = true;
         this._textureSeed = value;
         if (this._enableProceduralTexture) {
             this._textureNeedsUpdate = true;
@@ -499,222 +464,195 @@ export class NeatGradient {
         return this._textureEase;
     }
     set textureEase(value) {
+        this._uniformsDirty = true;
         this._textureEase = value;
     }
     set proceduralBackgroundColor(value) {
+        this._uniformsDirty = true;
         this._proceduralBackgroundColor = value;
         if (this._enableProceduralTexture) {
             this._textureNeedsUpdate = true;
         }
     }
     set textureShapeTriangles(value) {
+        this._uniformsDirty = true;
         this._textureShapeTriangles = value;
         if (this._enableProceduralTexture)
             this._textureNeedsUpdate = true;
     }
     set textureShapeCircles(value) {
+        this._uniformsDirty = true;
         this._textureShapeCircles = value;
         if (this._enableProceduralTexture)
             this._textureNeedsUpdate = true;
     }
     set textureShapeBars(value) {
+        this._uniformsDirty = true;
         this._textureShapeBars = value;
         if (this._enableProceduralTexture)
             this._textureNeedsUpdate = true;
     }
     set textureShapeSquiggles(value) {
+        this._uniformsDirty = true;
         this._textureShapeSquiggles = value;
         if (this._enableProceduralTexture)
             this._textureNeedsUpdate = true;
     }
+    _hexToRgb(hex) {
+        const bigint = parseInt(hex.replace('#', ''), 16);
+        return [
+            ((bigint >> 16) & 255) / 255.0,
+            ((bigint >> 8) & 255) / 255.0,
+            (bigint & 255) / 255.0
+        ];
+    }
     _initScene(resolution) {
-        const width = this._ref.width, height = this._ref.height;
-        // Cleanup existing renderer if needed
-        if (this.sceneState && this.sceneState.renderer) {
-            this.sceneState.renderer.dispose();
-            this.sceneState.meshes.forEach(m => {
-                m.geometry.dispose();
-                if (Array.isArray(m.material))
-                    m.material.forEach(mat => mat.dispose());
-                else
-                    m.material.dispose();
-            });
+        const width = this._ref.clientWidth;
+        const height = this._ref.clientHeight;
+        const gl = this._ref.getContext("webgl2", { alpha: true, preserveDrawingBuffer: true, antialias: true }) ||
+            this._ref.getContext("webgl", { alpha: true, preserveDrawingBuffer: true, antialias: true });
+        if (!gl) {
+            throw new Error("WebGL not supported");
         }
-        const renderer = new THREE.WebGLRenderer({
-            // antialias: true,
-            alpha: true,
-            preserveDrawingBuffer: true,
-            canvas: this._ref
-        });
-        renderer.setClearColor(0xFF0000, .5);
-        renderer.setSize(width, height, false);
-        const meshes = [];
-        const scene = new THREE.Scene();
-        const material = this._buildMaterial(width, height);
-        const geo = new THREE.PlaneGeometry(PLANE_WIDTH, PLANE_HEIGHT, 240 * resolution, 240 * resolution);
-        const plane = new THREE.Mesh(geo, material);
-        plane.rotation.x = -Math.PI / 3.5;
-        plane.position.z = -1;
-        meshes.push(plane);
-        scene.add(plane);
-        const camera = new THREE.OrthographicCamera(0.0, 0.0, 0.0, 0.0, 0.0, 0.0);
-        // const camera = new THREE.PerspectiveCamera( 1000, window.innerWidth / window.innerHeight, 1, 1000000 );
-        camera.position.z = 5;
+        const ext = gl.getExtension("OES_standard_derivatives");
+        gl.getExtension("OES_element_index_uint");
+        gl.viewport(0, 0, width, height);
+        // Generate plane geometry with Uint32Array for large meshes
+        const { position, normal, uv, index, wireframeIndex } = generatePlaneGeometry(PLANE_WIDTH, PLANE_HEIGHT, 240 * resolution, 240 * resolution);
+        const positionBuffer = gl.createBuffer();
+        gl.bindBuffer(gl.ARRAY_BUFFER, positionBuffer);
+        gl.bufferData(gl.ARRAY_BUFFER, position, gl.STATIC_DRAW);
+        const normalBuffer = gl.createBuffer();
+        gl.bindBuffer(gl.ARRAY_BUFFER, normalBuffer);
+        gl.bufferData(gl.ARRAY_BUFFER, normal, gl.STATIC_DRAW);
+        const uvBuffer = gl.createBuffer();
+        gl.bindBuffer(gl.ARRAY_BUFFER, uvBuffer);
+        gl.bufferData(gl.ARRAY_BUFFER, uv, gl.STATIC_DRAW);
+        const indexBuffer = gl.createBuffer();
+        gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, indexBuffer);
+        gl.bufferData(gl.ELEMENT_ARRAY_BUFFER, index, gl.STATIC_DRAW);
+        const wireframeIndexBuffer = gl.createBuffer();
+        gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, wireframeIndexBuffer);
+        gl.bufferData(gl.ELEMENT_ARRAY_BUFFER, wireframeIndex, gl.STATIC_DRAW);
+        // Rebind the triangle index buffer as default
+        gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, indexBuffer);
+        const vertShaderSourceCombined = buildVertUniforms() + "\n" + buildNoise() + "\n" + buildColorFunctions() + "\n" + vertexShaderSource;
+        const vertShader = gl.createShader(gl.VERTEX_SHADER);
+        gl.shaderSource(vertShader, vertShaderSourceCombined);
+        gl.compileShader(vertShader);
+        if (!gl.getShaderParameter(vertShader, gl.COMPILE_STATUS)) {
+            console.log("VERTEX_SHADER_ERROR_START");
+            console.log("Vertex shader error: ", gl.getShaderInfoLog(vertShader));
+            console.log("GL Error Code:", gl.getError());
+            console.log("Vertex Shader Source Dump:");
+            console.log(vertShaderSourceCombined.split('\n').map((line, i) => `${i + 1}: ${line}`).join('\n'));
+            console.log("VERTEX_SHADER_ERROR_END");
+        }
+        const fragShaderSourceCombined = buildFragUniforms() + "\n" + buildColorFunctions() + "\n" + buildNoise() + "\n" + fragmentShaderSource;
+        const fragShader = gl.createShader(gl.FRAGMENT_SHADER);
+        gl.shaderSource(fragShader, fragShaderSourceCombined);
+        gl.compileShader(fragShader);
+        if (!gl.getShaderParameter(fragShader, gl.COMPILE_STATUS)) {
+            console.log("FRAGMENT_SHADER_ERROR_START");
+            console.log("Fragment shader error: ", gl.getShaderInfoLog(fragShader));
+            console.log("GL Error Code:", gl.getError());
+            console.log("Fragment Shader Source Dump:");
+            console.log(fragShaderSourceCombined.split('\n').map((line, i) => `${i + 1}: ${line}`).join('\n'));
+            console.log("FRAGMENT_SHADER_ERROR_END");
+        }
+        const program = gl.createProgram();
+        gl.attachShader(program, vertShader);
+        gl.attachShader(program, fragShader);
+        gl.linkProgram(program);
+        if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
+            console.log("PROGRAM_LINK_ERROR_START");
+            console.log("Program linking error: ", gl.getProgramInfoLog(program));
+            console.log("GL Error Code:", gl.getError());
+            console.log("PROGRAM_LINK_ERROR_END");
+        }
+        gl.useProgram(program);
+        const camera = new OrthographicCamera(0, 0, 0, 0, 0, 1000);
+        camera.position = [0, 0, 5];
         updateCamera(camera, width, height);
-        return {
-            renderer,
-            camera,
-            scene,
-            meshes,
-            resolution
+        // Define attributes
+        const aPosition = gl.getAttribLocation(program, "position");
+        const aNormal = gl.getAttribLocation(program, "normal");
+        const aUv = gl.getAttribLocation(program, "uv");
+        gl.enableVertexAttribArray(aPosition);
+        gl.bindBuffer(gl.ARRAY_BUFFER, positionBuffer);
+        gl.vertexAttribPointer(aPosition, 3, gl.FLOAT, false, 0, 0);
+        gl.enableVertexAttribArray(aNormal);
+        gl.bindBuffer(gl.ARRAY_BUFFER, normalBuffer);
+        gl.vertexAttribPointer(aNormal, 3, gl.FLOAT, false, 0, 0);
+        gl.enableVertexAttribArray(aUv);
+        gl.bindBuffer(gl.ARRAY_BUFFER, uvBuffer);
+        gl.vertexAttribPointer(aUv, 2, gl.FLOAT, false, 0, 0);
+        gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, indexBuffer);
+        const modelViewMatrix = new Matrix4();
+        // The View Matrix is the inverse of the Camera's position
+        // Camera is at [0, 0, 5], so view matrix translates by [0, 0, -5]
+        modelViewMatrix.translate(-camera.position[0], -camera.position[1], -camera.position[2]);
+        // The Model Matrix mimicking: plane.rotation.x = -Math.PI / 3.5; plane.position.z = -1;
+        modelViewMatrix.translate(0, 0, -1);
+        modelViewMatrix.rotateX(-Math.PI / 3.5);
+        const mvLoc = gl.getUniformLocation(program, "modelViewMatrix");
+        gl.uniformMatrix4fv(mvLoc, false, modelViewMatrix.elements);
+        const projLoc = gl.getUniformLocation(program, "projectionMatrix");
+        gl.uniformMatrix4fv(projLoc, false, camera.projectionMatrix.elements);
+        const planeWidthLoc = gl.getUniformLocation(program, "u_plane_width");
+        gl.uniform1f(planeWidthLoc, PLANE_WIDTH);
+        const planeHeightLoc = gl.getUniformLocation(program, "u_plane_height");
+        gl.uniform1f(planeHeightLoc, PLANE_HEIGHT);
+        const colorsCountLoc = gl.getUniformLocation(program, "u_colors_count");
+        gl.uniform1i(colorsCountLoc, COLORS_COUNT);
+        const uniformsList = [
+            "u_time", "u_resolution", "u_color_pressure", "u_wave_frequency_x", "u_wave_frequency_y",
+            "u_wave_amplitude", "u_colors_count", "u_plane_width", "u_plane_height", "u_shadows",
+            "u_highlights", "u_grain_intensity", "u_grain_sparsity", "u_grain_scale", "u_grain_speed",
+            "u_flow_distortion_a", "u_flow_distortion_b", "u_flow_scale", "u_flow_ease", "u_flow_enabled",
+            "u_y_offset", "u_y_offset_wave_multiplier", "u_y_offset_color_multiplier", "u_y_offset_flow_multiplier",
+            "u_procedural_texture", "u_enable_procedural_texture", "u_texture_ease", "u_saturation", "u_brightness", "u_color_blending"
+        ];
+        const locations = {
+            attributes: { position: aPosition, normal: aNormal, uv: aUv },
+            uniforms: {}
         };
-    }
-    _buildMaterial(width, height) {
-        // Initialize stable array structure for colors
-        // We create 6 objects and just update them in the render loop to avoid GC
-        const colors = Array.from({ length: COLORS_COUNT }).map((_, i) => ({
-            is_active: i < this._colors.length ? (this._colors[i].enabled ? 1.0 : 0.0) : 0.0,
-            color: new THREE.Color(i < this._colors.length ? this._colors[i].color : 0x000000),
-            influence: i < this._colors.length ? (this._colors[i].influence || 0) : 0
-        }));
-        const uniforms = {
-            u_time: { value: 0 },
-            u_color_pressure: { value: new THREE.Vector2(this._horizontalPressure, this._verticalPressure) },
-            u_wave_frequency_x: { value: this._waveFrequencyX },
-            u_wave_frequency_y: { value: this._waveFrequencyY },
-            u_wave_amplitude: { value: this._waveAmplitude },
-            u_resolution: { value: new THREE.Vector2(width, height) },
-            u_colors: { value: colors },
-            u_colors_count: { value: this._colors.length },
-            u_plane_width: { value: PLANE_WIDTH },
-            u_plane_height: { value: PLANE_HEIGHT },
-            u_shadows: { value: this._shadows },
-            u_highlights: { value: this._highlights },
-            u_grain_intensity: { value: this._grainIntensity },
-            u_grain_sparsity: { value: this._grainSparsity },
-            u_grain_scale: { value: this._grainScale },
-            u_grain_speed: { value: this._grainSpeed },
-            // Flow field
-            u_flow_distortion_a: { value: this._flowDistortionA },
-            u_flow_distortion_b: { value: this._flowDistortionB },
-            u_flow_scale: { value: this._flowScale },
-            u_flow_ease: { value: this._flowEase },
-            u_flow_enabled: { value: this._flowEnabled ? 1.0 : 0.0 },
-            // Y offset multipliers
-            u_y_offset: { value: this._yOffset },
-            u_y_offset_wave_multiplier: { value: this._yOffsetWaveMultiplier },
-            u_y_offset_color_multiplier: { value: this._yOffsetColorMultiplier },
-            u_y_offset_flow_multiplier: { value: this._yOffsetFlowMultiplier },
-            // Mouse interaction
-            u_mouse_distortion_strength: { value: this._mouseDistortionStrength },
-            u_mouse_distortion_radius: { value: this._mouseDistortionRadius },
-            u_mouse_darken: { value: this._mouseDarken },
-            u_mouse_texture: { value: this._mouseFBO ? this._mouseFBO.texture : null },
-            // Procedural texture
-            u_procedural_texture: { value: this._proceduralTexture },
-            u_enable_procedural_texture: { value: this._enableProceduralTexture ? 1.0 : 0.0 },
-            u_texture_ease: { value: this._textureEase },
-            u_saturation: { value: this._saturation },
-            u_brightness: { value: this._brightness },
-            u_color_blending: { value: this._colorBlending }
-        };
-        const material = new THREE.ShaderMaterial({
-            uniforms: uniforms,
-            vertexShader: buildUniforms() + buildNoise() + buildColorFunctions() + buildVertexShader(),
-            fragmentShader: buildUniforms() + buildColorFunctions() + buildNoise() + buildFragmentShader()
+        uniformsList.forEach(name => {
+            locations.uniforms[name] = gl.getUniformLocation(program, name);
         });
-        // Cache the uniforms object for direct access in render loop
-        this._cachedUniforms = uniforms;
-        material.wireframe = WIREFRAME;
-        return material;
-    }
-    _setupMouseInteraction() {
-        if (!this._ref)
-            return;
-        const width = this._ref.width;
-        const height = this._ref.height;
-        // Create mouse FBO
-        this._mouseFBO = new THREE.WebGLRenderTarget(width / 2, height / 2);
-        // Create mouse scene and camera
-        this._sceneMouse = new THREE.Scene();
-        const fSize = height / 2;
-        const aspect = width / height;
-        // FIX 4: Ensure near plane allows viewing objects at Z=0
-        // Near -100 is safer for objects at 0
-        this._cameraMouse = new THREE.OrthographicCamera(-fSize * aspect, fSize * aspect, fSize, -fSize, 0, 10000);
-        this._cameraMouse.position.set(0, 0, 100);
-        // Create brush texture - More visible and impactful
-        const brushCanvas = document.createElement('canvas');
-        brushCanvas.width = 128;
-        brushCanvas.height = 128;
-        const bCtx = brushCanvas.getContext('2d');
-        if (bCtx) {
-            const grd = bCtx.createRadialGradient(64, 64, 0, 64, 64, 64);
-            // Match reference implementation's stronger gradient
-            grd.addColorStop(0, 'rgba(255,255,255,0.8)');
-            grd.addColorStop(0.5, 'rgba(255,255,255,0.4)');
-            grd.addColorStop(1, 'rgba(255,255,255,0)');
-            bCtx.fillStyle = grd;
-            bCtx.fillRect(0, 0, 128, 128);
+        // Add colors uniforms manually
+        for (let i = 0; i < COLORS_COUNT; i++) {
+            locations.uniforms[`u_colors[${i}].is_active`] = gl.getUniformLocation(program, `u_colors[${i}].is_active`);
+            locations.uniforms[`u_colors[${i}].color`] = gl.getUniformLocation(program, `u_colors[${i}].color`);
+            locations.uniforms[`u_colors[${i}].influence`] = gl.getUniformLocation(program, `u_colors[${i}].influence`);
         }
-        const brushTex = new THREE.CanvasTexture(brushCanvas);
-        const brushMat = new THREE.MeshBasicMaterial({
-            map: brushTex,
-            transparent: true,
-            opacity: 1.0,
-            depthTest: false,
-            blending: THREE.AdditiveBlending // Additive blending for better accumulation
-        });
-        // Brush geometry size - will be scaled by radius parameter
-        const brushGeo = new THREE.PlaneGeometry(200, 200);
-        // Create brush pool
-        const brushPoolSize = 50;
-        for (let i = 0; i < brushPoolSize; i++) {
-            const m = new THREE.Mesh(brushGeo, brushMat.clone());
-            m.visible = false;
-            this._sceneMouse.add(m);
-            this._mouseObjects.push({ mesh: m, active: false });
-        }
-        // Initialize brush scale based on current radius
-        this._updateBrushScale();
-        // Add mouse move listener
-        this._ref.addEventListener('mousemove', this._onMouseMove.bind(this));
-    }
-    _onMouseMove(e) {
-        if (!this._ref || !this._sceneMouse)
-            return;
-        const rect = this._ref.getBoundingClientRect();
-        const width = this._ref.width;
-        const height = this._ref.height;
-        // Store pending mouse position
-        this._pendingMousePosition = {
-            x: e.clientX - rect.left - width / 2,
-            y: -(e.clientY - rect.top - height / 2)
+        this._initialized = true;
+        // New program needs all uniforms re-uploaded on first frame
+        this._uniformsDirty = true;
+        this._colorsChanged = true;
+        this._textureDirty = true;
+        // Enable alpha blending
+        gl.enable(gl.BLEND);
+        gl.blendFunc(gl.SRC_ALPHA, gl.ONE_MINUS_SRC_ALPHA);
+        gl.enable(gl.DEPTH_TEST);
+        return {
+            gl,
+            program,
+            buffers: {
+                position: positionBuffer,
+                normal: normalBuffer,
+                uv: uvBuffer,
+                index: indexBuffer,
+                wireframeIndex: wireframeIndexBuffer
+            },
+            locations,
+            camera,
+            indexCount: index.length,
+            wireframeIndexCount: wireframeIndex.length,
+            indexType: (index instanceof Uint32Array) ? gl.UNSIGNED_INT : gl.UNSIGNED_SHORT
         };
-        // Batch mouse updates using requestAnimationFrame
-        if (!this._mouseUpdateScheduled) {
-            this._mouseUpdateScheduled = true;
-            requestAnimationFrame(() => {
-                this._mouseUpdateScheduled = false;
-                if (!this._pendingMousePosition)
-                    return;
-                this._mouse.x = this._pendingMousePosition.x;
-                this._mouse.y = this._pendingMousePosition.y;
-                const brush = this._mouseObjects[this._currentBrush];
-                brush.mesh.scale.set(this._mouseBrushBaseScale, this._mouseBrushBaseScale, 1.0);
-                brush.active = true;
-                brush.mesh.visible = true;
-                brush.mesh.position.set(this._mouse.x, this._mouse.y, 0);
-                brush.mesh.rotation.z = Math.random() * Math.PI * 2;
-                if (brush.mesh.material instanceof THREE.MeshBasicMaterial) {
-                    brush.mesh.material.opacity = 1.0;
-                }
-                this._currentBrush = (this._currentBrush + 1) % this._mouseObjects.length;
-                this._pendingMousePosition = null;
-            });
-        }
     }
-    _createProceduralTexture() {
+    _createProceduralTexture(gl) {
         // Texture size - 1024 provides good balance between quality and performance
         // Reduced from 2048 for better performance
         const texSize = 1024;
@@ -723,7 +661,7 @@ export class NeatGradient {
         sourceCanvas.height = texSize;
         const sCtx = sourceCanvas.getContext('2d', { willReadFrequently: true });
         if (!sCtx)
-            return new THREE.Texture();
+            return null;
         let seed = this._textureSeed;
         const baseSeed = this._textureSeed;
         function random() {
@@ -736,7 +674,7 @@ export class NeatGradient {
         };
         const colors = this._colors.filter(c => c.enabled).map(c => c.color);
         if (colors.length === 0)
-            return new THREE.Texture();
+            return null;
         // Helper functions
         function hexToRgb(hex) {
             const bigint = parseInt(hex.replace('#', ''), 16);
@@ -747,7 +685,7 @@ export class NeatGradient {
             };
         }
         function rgbToHex(r, g, b) {
-            return "#" + ((1 << 24) + (Math.round(r) << 16) + (Math.round(g) << 8) + Math.round(b)).toString(16).slice(1);
+            return "#" + ((1 << 24) + (Math.round(r) << 16) + (Math.round(g) << 8) + Math.round(b)).toString(16).slice(1).padStart(6, '0');
         }
         const getInterColor = () => {
             const c1 = colors[Math.floor(random() * colors.length)];
@@ -827,7 +765,7 @@ export class NeatGradient {
         canvas.height = texSize;
         const ctx = canvas.getContext('2d', { willReadFrequently: true });
         if (!ctx)
-            return new THREE.Texture();
+            return null;
         // Start filled with the chosen void color so gaps show that color
         ctx.fillStyle = baseColor;
         ctx.fillRect(0, 0, texSize, texSize);
@@ -862,519 +800,24 @@ export class NeatGradient {
             }
             // void segments: leave as baseColor
         }
-        const tex = new THREE.CanvasTexture(canvas);
-        // Use mipmapping for better quality when texture is scaled
-        tex.minFilter = THREE.LinearMipmapLinearFilter;
-        tex.magFilter = THREE.LinearFilter;
-        tex.wrapS = THREE.RepeatWrapping;
-        tex.wrapT = THREE.RepeatWrapping;
-        // Enable anisotropic filtering for much better quality when texture is stretched
-        // 16 is a commonly supported value that dramatically improves quality
-        tex.anisotropy = 16;
-        // Ensure mipmaps are generated
-        tex.needsUpdate = true;
-        return tex;
-    }
-}
-function updateCamera(camera, width, height) {
-    const viewPortAreaRatio = 1000000;
-    const areaViewPort = width * height;
-    const targetPlaneArea = areaViewPort / viewPortAreaRatio *
-        PLANE_WIDTH * PLANE_HEIGHT / 1.5;
-    const ratio = width / height;
-    const targetWidth = Math.sqrt(targetPlaneArea * ratio);
-    const targetHeight = targetPlaneArea / targetWidth;
-    let left = -PLANE_WIDTH / 2;
-    let right = Math.min((left + targetWidth) / 1.5, PLANE_WIDTH / 2);
-    let top = PLANE_HEIGHT / 4;
-    let bottom = Math.max((top - targetHeight) / 2, -PLANE_HEIGHT / 4);
-    // Fix for mobile portrait: adjust bounds for proper aspect ratio AND zoom out slightly
-    if (ratio < 1) {
-        // Portrait mode - scale horizontal bounds by aspect ratio to prevent stretching
-        const horizontalScale = ratio;
-        left = left * horizontalScale;
-        right = right * horizontalScale;
-        // Zoom out slightly on mobile (1.1 = 10% zoom out)
-        const mobileZoomFactor = 1.05;
-        left = left * mobileZoomFactor;
-        right = right * mobileZoomFactor;
-        top = top * mobileZoomFactor;
-        bottom = bottom * mobileZoomFactor;
-    }
-    const near = -100;
-    const far = 1000;
-    if (camera instanceof THREE.OrthographicCamera) {
-        camera.left = left;
-        camera.right = right;
-        camera.top = top;
-        camera.bottom = bottom;
-        camera.near = near;
-        camera.far = far;
-        camera.updateProjectionMatrix();
-    }
-    else if (camera instanceof THREE.PerspectiveCamera) {
-        camera.aspect = width / height;
-        camera.updateProjectionMatrix();
-    }
-}
-// Cache shader strings to avoid repeated concatenation
-let cachedVertexShader = null;
-let cachedFragmentShader = null;
-function buildVertexShader() {
-    if (cachedVertexShader)
-        return cachedVertexShader;
-    cachedVertexShader = `
-void main() {
-    vUv = uv;
-
-    // SCROLLING LOGIC
-    // Separate multipliers for wave, color, and flow offsets
-    float waveOffset = -u_y_offset * u_y_offset_wave_multiplier;
-    float colorOffset = -u_y_offset * u_y_offset_color_multiplier;
-    float flowOffset = -u_y_offset * u_y_offset_flow_multiplier;
-
-    // 1. DISPLACEMENT (WAVES)
-    // We add waveOffset to Y to scroll the wave pattern
-    v_displacement_amount = cnoise( vec3(
-        u_wave_frequency_x * position.x + u_time,
-        u_wave_frequency_y * (position.y + waveOffset) + u_time,
-        u_time
-    ));
-
-    // 2. FLOW FIELD
-    // Apply flow offset to scroll the flow field mask
-    vec2 baseUv = vUv;
-    baseUv.y += flowOffset / u_plane_height; // Scale to match wave speed
-    vec2 flowUv = baseUv;
-
-    if (u_flow_enabled > 0.5) {
-        if (u_flow_ease > 0.0 || u_flow_distortion_a > 0.0) {
-            vec2 ppp = -1.0 + 2.0 * baseUv;
-            ppp += 0.1 * cos((1.5 * u_flow_scale) * ppp.yx + 1.1 * u_time + vec2(0.1, 1.1));
-            ppp += 0.1 * cos((2.3 * u_flow_scale) * ppp.yx + 1.3 * u_time + vec2(3.2, 3.4));
-            ppp += 0.1 * cos((2.2 * u_flow_scale) * ppp.yx + 1.7 * u_time + vec2(1.8, 5.2));
-            ppp += u_flow_distortion_a * cos((u_flow_distortion_b * u_flow_scale) * ppp.yx + 1.4 * u_time + vec2(6.3, 3.9));
-
-            float r = length(ppp);
-            flowUv = mix(baseUv, vec2(baseUv.x * (1.0 - u_flow_ease) + r * u_flow_ease, baseUv.y), u_flow_ease);
-        }
-    }
-
-    // Pass the standard flow UV to fragment shader (for mouse/texture)
-    vFlowUv = flowUv;
-
-    // 3. COLOR MIXING
-    // We take the computed flow UVs and apply the color offset
-    // Scale by plane height to match wave offset speed (world space vs UV space)
-    vec3 color = u_colors[0].color;
-    vec2 adjustedUv = flowUv;
-    adjustedUv.y += colorOffset / u_plane_height; // Scroll the color mixing pattern
-
-    vec2 noise_cord = adjustedUv * u_color_pressure;
-    const float minNoise = .0;
-    const float maxNoise = .9;
-
-    for (int i = 1; i < u_colors_count; i++) {
-        if(u_colors[i].is_active > 0.5){
-            float noiseFlow = (1. + float(i)) / 30.;
-            float noiseSpeed = (1. + float(i)) * 0.11;
-            float noiseSeed = 13. + float(i) * 7.;
-
-            float noise = snoise(
-                vec3(
-                    noise_cord.x * u_color_pressure.x + u_time * noiseFlow * 2.,
-                    noise_cord.y * u_color_pressure.y,
-                    u_time * noiseSpeed
-                ) + noiseSeed
-            ) - (.1 * float(i)) + (.5 * u_color_blending);
-
-            noise = clamp(minNoise, maxNoise + float(i) * 0.02, noise);
-            color = mix(color, u_colors[i].color, smoothstep(0.0, u_color_blending, noise));
-        }
-    }
-
-    v_color = color;
-
-    // 4. VERTEX POSITION
-    vec3 newPosition = position + normal * v_displacement_amount * u_wave_amplitude;
-    gl_Position = projectionMatrix * modelViewMatrix * vec4(newPosition, 1.0);
-    v_new_position = gl_Position;
-}
-`;
-    return cachedVertexShader;
-}
-function buildFragmentShader() {
-    if (cachedFragmentShader)
-        return cachedFragmentShader;
-    cachedFragmentShader = `
-float random(vec2 p) {
-    return fract(sin(dot(p, vec2(12.9898,78.233))) * 43758.5453);
-}
-
-float fbm(vec3 x) {
-    float value = 0.0;
-    float amplitude = 0.5;
-    float frequency = 1.0;
-    for (int i = 0; i < 4; i++) {
-        value += amplitude * snoise(x * frequency);
-        frequency *= 2.0;
-        amplitude *= 0.5;
-    }
-    return value;
-}
-
-void main() {
-    // MOUSE DISTORTION
-    vec2 finalUv = vFlowUv;
-    
-    if (u_mouse_distortion_strength > 0.0) {
-        vec4 mouseColor = texture2D(u_mouse_texture, vUv);
-        float mouseValue = mouseColor.r;
-        
-        if (mouseValue > 0.001) {
-            float distortionAmount = mouseValue * u_mouse_distortion_strength;
-            vec2 mouseDisp = vec2(distortionAmount, distortionAmount);
-            finalUv -= mouseDisp;
+        const tex = gl.createTexture();
+        gl.bindTexture(gl.TEXTURE_2D, tex);
+        gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, canvas);
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.REPEAT);
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.REPEAT);
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR_MIPMAP_LINEAR);
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
+        gl.generateMipmap(gl.TEXTURE_2D);
+        const ext = gl.getExtension('EXT_texture_filter_anisotropic') ||
+            gl.getExtension('MOZ_EXT_texture_filter_anisotropic') ||
+            gl.getExtension('WEBKIT_EXT_texture_filter_anisotropic');
+        if (ext) {
+            const max = gl.getParameter(ext.MAX_TEXTURE_MAX_ANISOTROPY_EXT);
+            gl.texParameterf(gl.TEXTURE_2D, ext.TEXTURE_MAX_ANISOTROPY_EXT, Math.min(16, max));
         }
+        return tex;
     }
-    
-    vec3 baseColor;
-
-    if (u_enable_procedural_texture > 0.5) {
-        // Calculate flow field distance for ease effect
-        vec2 ppp = -1.0 + 2.0 * finalUv;
-        ppp += 0.1 * cos((1.5 * u_flow_scale) * ppp.yx + 1.1 * u_time + vec2(0.1, 1.1));
-        ppp += 0.1 * cos((2.3 * u_flow_scale) * ppp.yx + 1.3 * u_time + vec2(3.2, 3.4));
-        ppp += 0.1 * cos((2.2 * u_flow_scale) * ppp.yx + 1.7 * u_time + vec2(1.8, 5.2));
-        ppp += u_flow_distortion_a * cos((u_flow_distortion_b * u_flow_scale) * ppp.yx + 1.4 * u_time + vec2(6.3, 3.9));
-        float r = length(ppp); // Flow distance
-        
-        // Ease blending: 0 = topographic (flow), 1 = image (UV)
-        float vx = (finalUv.x * u_texture_ease) + (r * (1.0 - u_texture_ease));
-        float vy = (finalUv.y * u_texture_ease) + (0.0 * (1.0 - u_texture_ease));
-        vec2 texUv = vec2(vx, vy);
-
-        // PARALLAX SCROLLING
-        // We manually apply a smaller offset here to make the texture lag behind
-        float parallaxFactor = 0.25; // 25% speed of the color mixing
-        texUv.y -= (u_y_offset * u_y_offset_color_multiplier / u_plane_height) * parallaxFactor;
-
-        texUv *= 1.5; // Tiling scale
-
-        vec4 texSample = texture2D(u_procedural_texture, texUv);
-        baseColor = texSample.rgb;
-    } else {
-        baseColor = v_color;
-    }
-
-    vec3 color = baseColor;
-
-    // Post-processing
-    color += pow(v_displacement_amount, 1.0) * u_highlights;
-    color -= pow(1.0 - v_displacement_amount, 2.0) * u_shadows;
-    color = saturation(color, 1.0 + u_saturation);
-    color = color * u_brightness;
-
-    // Grain
-    vec2 noiseCoords = gl_FragCoord.xy / u_grain_scale;
-    float grain = (u_grain_speed != 0.0) ? fbm(vec3(noiseCoords, u_time * u_grain_speed)) : fbm(vec3(noiseCoords, 0.0));
-
-    grain = grain * 0.5 + 0.5;
-    grain -= 0.5;
-    grain = (grain > u_grain_sparsity) ? grain : 0.0;
-    grain *= u_grain_intensity;
-
-    color += vec3(grain);
-
-    gl_FragColor = vec4(color, 1.0);
-}
-    `;
-    return cachedFragmentShader;
-}
-// Cache uniforms string as well
-let cachedUniformsShader = null;
-const buildUniforms = () => {
-    if (cachedUniformsShader)
-        return cachedUniformsShader;
-    cachedUniformsShader = `
-precision highp float;
-
-struct Color {
-    float is_active;
-    vec3 color;
-    float value;
-};
-
-uniform float u_grain_intensity; 
-uniform float u_grain_sparsity; 
-uniform float u_grain_scale; 
-uniform float u_grain_speed; 
-uniform float u_time;
-
-uniform float u_wave_amplitude;
-uniform float u_wave_frequency_x;
-uniform float u_wave_frequency_y;
-
-uniform vec2 u_color_pressure;
-
-uniform float u_plane_width;
-uniform float u_plane_height;
-
-uniform float u_shadows;
-uniform float u_highlights;
-uniform float u_saturation;
-uniform float u_brightness;
-
-uniform float u_color_blending;
-
-uniform int u_colors_count;
-uniform Color u_colors[6];
-uniform vec2 u_resolution;
-
-uniform float u_y_offset;
-uniform float u_y_offset_wave_multiplier;
-uniform float u_y_offset_color_multiplier;
-uniform float u_y_offset_flow_multiplier;
-
-// Flow field uniforms
-uniform float u_flow_distortion_a;
-uniform float u_flow_distortion_b;
-uniform float u_flow_scale;
-uniform float u_flow_ease;
-uniform float u_flow_enabled;
-
-// Mouse interaction uniforms
-uniform float u_mouse_distortion_strength;
-uniform float u_mouse_distortion_radius;
-uniform float u_mouse_darken;
-uniform sampler2D u_mouse_texture;
-
-// Procedural texture uniforms
-uniform sampler2D u_procedural_texture;
-uniform float u_enable_procedural_texture;
-uniform float u_texture_ease;
-
-varying vec2 vUv;
-varying vec2 vFlowUv;
-varying vec4 v_new_position;
-varying vec3 v_color;
-varying float v_displacement_amount;
-
-    `;
-    return cachedUniformsShader;
-};
-// Cache noise functions as well
-let cachedNoiseShader = null;
-const buildNoise = () => {
-    if (cachedNoiseShader)
-        return cachedNoiseShader;
-    cachedNoiseShader = `
-
-// 1. REPLACEMENT PERMUTE: 
-// Uses a hash function (fract/sin) instead of a modular lookup table.
-vec4 permute(vec4 x) {
-    return floor(fract(sin(x) * 43758.5453123) * 289.0);
-}
-
-// Taylor Inverse Sqrt
-vec4 taylorInvSqrt(vec4 r) {
-  return 1.79284291400159 - 0.85373472095314 * r;
-}
-
-// Fade function
-vec3 fade(vec3 t) {
-  return t*t*t*(t*(t*6.0-15.0)+10.0);
-}
-
-// 3D Simplex Noise
-float snoise(vec3 v) {
-  const vec2  C = vec2(1.0/6.0, 1.0/3.0) ;
-  const vec4  D = vec4(0.0, 0.5, 1.0, 2.0);
-
-  // First corner
-  vec3 i  = floor(v + dot(v, C.yyy) );
-  vec3 x0 =   v - i + dot(i, C.xxx) ;
-
-  // Other corners
-  vec3 g = step(x0.yzx, x0.xyz);
-  vec3 l = 1.0 - g;
-  vec3 i1 = min( g.xyz, l.zxy );
-  vec3 i2 = max( g.xyz, l.zxy );
-
-  vec3 x1 = x0 - i1 + C.xxx;
-  vec3 x2 = x0 - i2 + C.yyy;
-  vec3 x3 = x0 - D.yyy;
-
-  // Permutations
-  vec4 p = permute( permute( permute(
-            i.z + vec4(0.0, i1.z, i2.z, 1.0 ))
-          + i.y + vec4(0.0, i1.y, i2.y, 1.0 ))
-          + i.x + vec4(0.0, i1.x, i2.x, 1.0 ));
-
-  // Gradients
-  float n_ = 0.142857142857; // 1.0/7.0
-  vec3  ns = n_ * D.wyz - D.xzx;
-
-  vec4 j = p - 49.0 * floor(p * ns.z * ns.z);
-
-  vec4 x_ = floor(j * ns.z);
-  vec4 y_ = floor(j - 7.0 * x_ );
-
-  vec4 x = x_ *ns.x + ns.yyyy;
-  vec4 y = y_ *ns.x + ns.yyyy;
-  vec4 h = 1.0 - abs(x) - abs(y);
-
-  vec4 b0 = vec4( x.xy, y.xy );
-  vec4 b1 = vec4( x.zw, y.zw );
-
-  vec4 s0 = floor(b0)*2.0 + 1.0;
-  vec4 s1 = floor(b1)*2.0 + 1.0;
-  vec4 sh = -step(h, vec4(0.0));
-
-  vec4 a0 = b0.xzyw + s0.xzyw*sh.xxyy ;
-  vec4 a1 = b1.xzyw + s1.xzyw*sh.zzww ;
-
-  vec3 p0 = vec3(a0.xy,h.x);
-  vec3 p1 = vec3(a0.zw,h.y);
-  vec3 p2 = vec3(a1.xy,h.z);
-  vec3 p3 = vec3(a1.zw,h.w);
-
-  // Normalise gradients
-  vec4 norm = taylorInvSqrt(vec4(dot(p0,p0), dot(p1,p1), dot(p2, p2), dot(p3,p3)));
-  p0 *= norm.x;
-  p1 *= norm.y;
-  p2 *= norm.z;
-  p3 *= norm.w;
-
-  // Mix final noise value
-  vec4 m = max(0.6 - vec4(dot(x0,x0), dot(x1,x1), dot(x2,x2), dot(x3,x3)), 0.0);
-  m = m * m;
-  return 42.0 * dot( m*m, vec4( dot(p0,x0), dot(p1,x1),
-                                dot(p2,x2), dot(p3,x3) ) );
 }
-
-// Classic Perlin noise
-float cnoise(vec3 P)
-{
-  vec3 Pi0 = floor(P); 
-  vec3 Pi1 = Pi0 + vec3(1.0); 
-  
-  vec3 Pf0 = fract(P); 
-  vec3 Pf1 = Pf0 - vec3(1.0); 
-  vec4 ix = vec4(Pi0.x, Pi1.x, Pi0.x, Pi1.x);
-  vec4 iy = vec4(Pi0.yy, Pi1.yy);
-  vec4 iz0 = Pi0.zzzz;
-  vec4 iz1 = Pi1.zzzz;
-
-  vec4 ixy = permute(permute(ix) + iy);
-  vec4 ixy0 = permute(ixy + iz0);
-  vec4 ixy1 = permute(ixy + iz1);
-
-  vec4 gx0 = ixy0 * (1.0 / 7.0);
-  vec4 gy0 = fract(floor(gx0) * (1.0 / 7.0)) - 0.5;
-  gx0 = fract(gx0);
-  vec4 gz0 = vec4(0.5) - abs(gx0) - abs(gy0);
-  vec4 sz0 = step(gz0, vec4(0.0));
-  gx0 -= sz0 * (step(0.0, gx0) - 0.5);
-  gy0 -= sz0 * (step(0.0, gy0) - 0.5);
-
-  vec4 gx1 = ixy1 * (1.0 / 7.0);
-  vec4 gy1 = fract(floor(gx1) * (1.0 / 7.0)) - 0.5;
-  gx1 = fract(gx1);
-  vec4 gz1 = vec4(0.5) - abs(gx1) - abs(gy1);
-  vec4 sz1 = step(gz1, vec4(0.0));
-  gx1 -= sz1 * (step(0.0, gx1) - 0.5);
-  gy1 -= sz1 * (step(0.0, gy1) - 0.5);
-
-  vec3 g000 = vec3(gx0.x,gy0.x,gz0.x);
-  vec3 g100 = vec3(gx0.y,gy0.y,gz0.y);
-  vec3 g010 = vec3(gx0.z,gy0.z,gz0.z);
-  vec3 g110 = vec3(gx0.w,gy0.w,gz0.w);
-  vec3 g001 = vec3(gx1.x,gy1.x,gz1.x);
-  vec3 g101 = vec3(gx1.y,gy1.y,gz1.y);
-  vec3 g011 = vec3(gx1.z,gy1.z,gz1.z);
-  vec3 g111 = vec3(gx1.w,gy1.w,gz1.w);
-
-  vec4 norm0 = taylorInvSqrt(vec4(dot(g000, g000), dot(g010, g010), dot(g100, g100), dot(g110, g110)));
-  g000 *= norm0.x;
-  g010 *= norm0.y;
-  g100 *= norm0.z;
-  g110 *= norm0.w;
-  vec4 norm1 = taylorInvSqrt(vec4(dot(g001, g001), dot(g011, g011), dot(g101, g101), dot(g111, g111)));
-  g001 *= norm1.x;
-  g011 *= norm1.y;
-  g101 *= norm1.z;
-  g111 *= norm1.w;
-
-  float n000 = dot(g000, Pf0);
-  float n100 = dot(g100, vec3(Pf1.x, Pf0.yz));
-  float n010 = dot(g010, vec3(Pf0.x, Pf1.y, Pf0.z));
-  float n110 = dot(g110, vec3(Pf1.xy, Pf0.z));
-  float n001 = dot(g001, vec3(Pf0.xy, Pf1.z));
-  float n101 = dot(g101, vec3(Pf1.x, Pf0.y, Pf1.z));
-  float n011 = dot(g011, vec3(Pf0.x, Pf1.yz));
-  float n111 = dot(g111, Pf1);
-
-  vec3 fade_xyz = fade(Pf0);
-  vec4 n_z = mix(vec4(n000, n100, n010, n110), vec4(n001, n101, n011, n111), fade_xyz.z);
-  vec2 n_yz = mix(n_z.xy, n_z.zw, fade_xyz.y);
-  float n_xyz = mix(n_yz.x, n_yz.y, fade_xyz.x);
-  return 2.2 * n_xyz;
-}
-`;
-    return cachedNoiseShader;
-};
-// Cache color functions as well
-let cachedColorFunctionsShader = null;
-const buildColorFunctions = () => {
-    if (cachedColorFunctionsShader)
-        return cachedColorFunctionsShader;
-    cachedColorFunctionsShader = `
-
-vec3 saturation(vec3 rgb, float adjustment) {
-    const vec3 W = vec3(0.2125, 0.7154, 0.0721);
-    vec3 intensity = vec3(dot(rgb, W));
-    return mix(intensity, rgb, adjustment);
-}
-
-float saturation(vec3 rgb)
-{
-    vec4 K = vec4(0.0, -1.0 / 3.0, 2.0 / 3.0, -1.0);
-    vec4 p = mix(vec4(rgb.bg, K.wz), vec4(rgb.gb, K.xy), step(rgb.b, rgb.g));
-    vec4 q = mix(vec4(p.xyw, rgb.r), vec4(rgb.r, p.yzx), step(p.x, rgb.r));
-
-    float d = q.x - min(q.w, q.y);
-    float e = 1.0e-10;
-    return abs(6.0 * d + e);
-}
-
-// get saturation of a color in values between 0 and 1
-float getSaturation(vec3 color) {
-    float max = max(color.r, max(color.g, color.b));
-    float min = min(color.r, min(color.g, color.b));
-    return (max - min) / max;
-}
-    
-vec3 rgb2hsv(vec3 c)
-{
-    vec4 K = vec4(0.0, -1.0 / 3.0, 2.0 / 3.0, -1.0);
-    vec4 p = mix(vec4(c.bg, K.wz), vec4(c.gb, K.xy), step(c.b, c.g));
-    vec4 q = mix(vec4(p.xyw, c.r), vec4(c.r, p.yzx), step(p.x, c.r));
-
-    float d = q.x - min(q.w, q.y);
-    float e = 1.0e-10;
-    return vec3(abs(q.z + (q.w - q.y) / (6.0 * d + e)), d / (q.x + e), q.x);
-}
-
-vec3 hsv2rgb(vec3 c)
-{
-    vec4 K = vec4(1.0, 2.0 / 3.0, 1.0 / 3.0, 3.0);
-    vec3 p = abs(fract(c.xxx + K.xyz) * 6.0 - K.www);
-    return c.z * mix(K.xxx, clamp(p - K.xxx, 0.0, 1.0), c.y);
-}
-`;
-    return cachedColorFunctionsShader;
-};
 const setLinkStyles = (link) => {
     link.id = LINK_ID;
     link.href = "https://neat.firecms.co";
@@ -1391,21 +834,27 @@ const setLinkStyles = (link) => {
     link.style.fontWeight = "bold";
     link.style.textDecoration = "none";
     link.style.zIndex = "10000";
+    link.style.pointerEvents = "auto";
+    link.setAttribute("data-n", "1");
     link.innerHTML = "NEAT";
 };
 const addNeatLink = (ref) => {
-    const existingLinks = ref.parentElement?.getElementsByTagName("a");
-    if (existingLinks) {
-        for (let i = 0; i < existingLinks.length; i++) {
-            if (existingLinks[i].id === LINK_ID) {
-                setLinkStyles(existingLinks[i]);
-                return existingLinks[i];
-            }
+    const parent = ref.parentElement;
+    // Ensure parent has position so absolute link is positioned relative to it
+    if (parent && getComputedStyle(parent).position === "static") {
+        parent.style.position = "relative";
+    }
+    // Search parent for existing neat link (survives HMR where LINK_ID changes)
+    if (parent) {
+        const existing = parent.querySelector('a[data-n]');
+        if (existing) {
+            setLinkStyles(existing);
+            return existing;
         }
     }
     const link = document.createElement("a");
     setLinkStyles(link);
-    ref.parentElement?.appendChild(link);
+    parent?.appendChild(link);
     return link;
 };
 function getElapsedSecondsInLastHour() {