@vib3code/sdk 2.0.3-canary.91a95f3 → 2.0.3-canary.98b84da

package/src/shaders/common/geometry24.wgsl

@@ -47,6 +47,60 @@ fn hypertetrahedronCore(p: vec4<f32>, baseType: f32) -> f32 {
     return max(baseGeometry(p, baseType), tf);
 }
 
+// ── Polytope Core Warp Functions ──
+// Requires: rotation functions from rotation4d.wgsl and u: VIB3Uniforms
+
+fn warpHypersphereCore_common(p: vec3<f32>, geomIdx: i32) -> vec3<f32> {
+    let radius = length(p);
+    let morphBlend = clamp(u.morphFactor * 0.6 + (u.dimension - 3.0) * 0.25, 0.0, 2.0);
+    let w = sin(radius * (1.3 + f32(geomIdx) * 0.12) + u.time * 0.0008 * u.speed)
+          * (0.4 + morphBlend * 0.45);
+    var p4d = vec4<f32>(p * (1.0 + morphBlend * 0.2), w);
+    p4d = rotateXY(u.rot4dXY) * p4d;
+    p4d = rotateXZ(u.rot4dXZ) * p4d;
+    p4d = rotateYZ(u.rot4dYZ) * p4d;
+    p4d = rotateXW(u.rot4dXW) * p4d;
+    p4d = rotateYW(u.rot4dYW) * p4d;
+    p4d = rotateZW(u.rot4dZW) * p4d;
+    let proj = project4Dto3D(p4d);
+    return mix(p, proj, clamp(0.45 + morphBlend * 0.35, 0.0, 1.0));
+}
+
+fn warpHypertetraCore_common(p: vec3<f32>, geomIdx: i32) -> vec3<f32> {
+    let c1 = normalize(vec3<f32>(1.0, 1.0, 1.0));
+    let c2 = normalize(vec3<f32>(-1.0, -1.0, 1.0));
+    let c3 = normalize(vec3<f32>(-1.0, 1.0, -1.0));
+    let c4 = normalize(vec3<f32>(1.0, -1.0, -1.0));
+    let morphBlend = clamp(u.morphFactor * 0.8 + (u.dimension - 3.0) * 0.2, 0.0, 2.0);
+    let basisMix = dot(p, c1) * 0.14 + dot(p, c2) * 0.1 + dot(p, c3) * 0.08;
+    let w = sin(basisMix * 5.5 + u.time * 0.0009 * u.speed)
+          * cos(dot(p, c4) * 4.2 - u.time * 0.0007 * u.speed)
+          * (0.5 + morphBlend * 0.4);
+    let offset = vec3<f32>(dot(p, c1), dot(p, c2), dot(p, c3)) * 0.1 * morphBlend;
+    var p4d = vec4<f32>(p + offset, w);
+    p4d = rotateXY(u.rot4dXY) * p4d;
+    p4d = rotateXZ(u.rot4dXZ) * p4d;
+    p4d = rotateYZ(u.rot4dYZ) * p4d;
+    p4d = rotateXW(u.rot4dXW) * p4d;
+    p4d = rotateYW(u.rot4dYW) * p4d;
+    p4d = rotateZW(u.rot4dZW) * p4d;
+    let proj = project4Dto3D(p4d);
+    let planeInf = min(min(abs(dot(p, c1)), abs(dot(p, c2))),
+                       min(abs(dot(p, c3)), abs(dot(p, c4))));
+    let blended = mix(p, proj, clamp(0.45 + morphBlend * 0.35, 0.0, 1.0));
+    return mix(blended, blended * (1.0 - planeInf * 0.55), 0.2 + morphBlend * 0.2);
+}
+
+fn applyCoreWarp_common(p: vec3<f32>, geomType: f32) -> vec3<f32> {
+    let coreFloat = floor(geomType / 8.0);
+    let coreIndex = i32(clamp(coreFloat, 0.0, 2.0));
+    let baseFloat = geomType - floor(geomType / 8.0) * 8.0;
+    let geomIdx = i32(clamp(floor(baseFloat + 0.5), 0.0, 7.0));
+    if (coreIndex == 1) { return warpHypersphereCore_common(p, geomIdx); }
+    if (coreIndex == 2) { return warpHypertetraCore_common(p, geomIdx); }
+    return p;
+}
+
 fn geometry(p: vec4<f32>, t: f32) -> f32 {
     if (t < 8.0) { return baseGeometry(p, t); }
     else if (t < 16.0) { return hypersphereCore(p, t - 8.0); }

package/src/shaders/common/rotation4d.glsl

@@ -16,10 +16,10 @@ mat4 rotateXZ(float angle) {
     float c = cos(angle);
     float s = sin(angle);
     return mat4(
-        c, 0, -s, 0,
-        0, 1,  0, 0,
-        s, 0,  c, 0,
-        0, 0,  0, 1
+         c, 0, s, 0,
+         0, 1, 0, 0,
+        -s, 0, c, 0,
+         0, 0, 0, 1
     );
 }
 

package/src/shaders/common/rotation4d.wgsl

@@ -16,9 +16,9 @@ fn rotateXZ(angle: f32) -> mat4x4<f32> {
     let c = cos(angle);
     let s = sin(angle);
     return mat4x4<f32>(
-        vec4<f32>(c, 0.0, -s, 0.0),
+        vec4<f32>( c, 0.0, s, 0.0),
         vec4<f32>(0.0, 1.0, 0.0, 0.0),
-        vec4<f32>(s, 0.0,  c, 0.0),
+        vec4<f32>(-s, 0.0, c, 0.0),
         vec4<f32>(0.0, 0.0, 0.0, 1.0)
     );
 }

package/src/shaders/common/uniforms.wgsl

@@ -1,16 +1,19 @@
 // VIB3+ Common Uniform Struct (WGSL)
 // Shared across all visualization systems
+// Canonical layout — must match packVIB3Uniforms() in UnifiedRenderBridge.js
+// All fields are f32 (except resolution vec2) to avoid alignment surprises.
+// Total: 33 floats (132 bytes), buffer padded to 256 bytes.
 
 struct VIB3Uniforms {
-    // Time and resolution
+    // Time and resolution (indices 0-3)
     time: f32,
     _pad0: f32,
     resolution: vec2<f32>,
 
-    // Geometry selection (0-23)
+    // Geometry selection 0-23 (index 4)
     geometry: f32,
 
-    // 6D Rotation (radians)
+    // 6D Rotation in radians (indices 5-10)
     rot4dXY: f32,
     rot4dXZ: f32,
     rot4dYZ: f32,
@@ -18,7 +21,7 @@ struct VIB3Uniforms {
     rot4dYW: f32,
     rot4dZW: f32,
 
-    // Visual parameters
+    // Visual parameters (indices 11-18)
     dimension: f32,
     gridDensity: f32,
     morphFactor: f32,
@@ -28,21 +31,25 @@ struct VIB3Uniforms {
     intensity: f32,
     saturation: f32,
 
-    // Reactivity
+    // Reactivity (indices 19-23)
     mouseIntensity: f32,
     clickIntensity: f32,
     bass: f32,
     mid: f32,
     high: f32,
 
-    // Layer parameters (holographic multi-layer)
+    // Layer parameters (indices 24-31)
     layerScale: f32,
     layerOpacity: f32,
     _pad1: f32,
-    layerColor: vec3<f32>,
+    layerColorR: f32,
+    layerColorG: f32,
+    layerColorB: f32,
     densityMult: f32,
     speedMult: f32,
-    _pad2: vec3<f32>,
+
+    // Vitality (index 32)
+    breath: f32,
 };
 
 @group(0) @binding(0) var<uniform> u: VIB3Uniforms;

package/src/shaders/faceted/faceted.frag.wgsl

@@ -4,7 +4,7 @@
 
 struct VIB3Uniforms {
     time: f32,
-    speed: f32,
+    _pad0: f32,
     resolution: vec2<f32>,
     geometry: f32,
     rot4dXY: f32,
@@ -17,18 +17,24 @@ struct VIB3Uniforms {
     gridDensity: f32,
     morphFactor: f32,
     chaos: f32,
+    speed: f32,
     hue: f32,
     intensity: f32,
     saturation: f32,
     mouseIntensity: f32,
     clickIntensity: f32,
-    roleIntensity: f32,
     bass: f32,
     mid: f32,
     high: f32,
+    layerScale: f32,
+    layerOpacity: f32,
+    _pad1: f32,
+    layerColorR: f32,
+    layerColorG: f32,
+    layerColorB: f32,
+    densityMult: f32,
+    speedMult: f32,
     breath: f32,
-    mouse: vec2<f32>,
-    _pad1: vec2<f32>,
 };
 
 @group(0) @binding(0) var<uniform> u: VIB3Uniforms;
@@ -131,8 +137,15 @@ fn geometryFunction_w(p: vec4<f32>) -> f32 {
     let gt = i32(clamp(floor(baseFloat + 0.5), 0.0, 7.0));
     let d = u.gridDensity * 0.08;
     if (gt == 0) {
-        let pos = fract(p * d); let dist = min(pos, 1.0 - pos);
-        return min(min(dist.x, dist.y), min(dist.z, dist.w)) * u.morphFactor;
+        // Tetrahedron — tetrahedral symmetry planes
+        let c1 = normalize(vec3<f32>(1.0, 1.0, 1.0));
+        let c2 = normalize(vec3<f32>(-1.0, -1.0, 1.0));
+        let c3 = normalize(vec3<f32>(-1.0, 1.0, -1.0));
+        let c4 = normalize(vec3<f32>(1.0, -1.0, -1.0));
+        let q = fract(p.xyz * d + 0.5) - 0.5;
+        let minPlane = min(min(abs(dot(q, c1)), abs(dot(q, c2))),
+                           min(abs(dot(q, c3)), abs(dot(q, c4))));
+        return (1.0 - smoothstep(0.0, 0.05, minPlane)) * u.morphFactor;
     } else if (gt == 1) {
         let pos = fract(p * d); let dist = min(pos, 1.0 - pos);
         return min(min(dist.x, dist.y), min(dist.z, dist.w)) * u.morphFactor;

package/src/shaders/holographic/holographic.frag.wgsl

@@ -28,11 +28,13 @@ struct VIB3Uniforms {
     high: f32,
     layerScale: f32,
     layerOpacity: f32,
-    breath: f32,
-    layerColor: vec3<f32>,
+    _pad1: f32,
+    layerColorR: f32,
+    layerColorG: f32,
+    layerColorB: f32,
     densityMult: f32,
     speedMult: f32,
-    _pad2: vec3<f32>,
+    breath: f32,
 };
 
 @group(0) @binding(0) var<uniform> u: VIB3Uniforms;
@@ -52,8 +54,8 @@ fn rotateXY(angle: f32) -> mat4x4<f32> {
 fn rotateXZ(angle: f32) -> mat4x4<f32> {
     let c = cos(angle); let s = sin(angle);
     return mat4x4<f32>(
-        vec4<f32>(c, 0.0, -s, 0.0), vec4<f32>(0.0, 1.0, 0.0, 0.0),
-        vec4<f32>(s, 0.0, c, 0.0), vec4<f32>(0.0, 0.0, 0.0, 1.0));
+        vec4<f32>(c, 0.0, s, 0.0), vec4<f32>(0.0, 1.0, 0.0, 0.0),
+        vec4<f32>(-s, 0.0, c, 0.0), vec4<f32>(0.0, 0.0, 0.0, 1.0));
 }
 fn rotateYZ(angle: f32) -> mat4x4<f32> {
     let c = cos(angle); let s = sin(angle);

package/src/shaders/quantum/quantum.frag.wgsl

@@ -28,11 +28,13 @@ struct VIB3Uniforms {
     high: f32,
     layerScale: f32,
     layerOpacity: f32,
-    breath: f32,
-    layerColor: vec3<f32>,
+    _pad1: f32,
+    layerColorR: f32,
+    layerColorG: f32,
+    layerColorB: f32,
     densityMult: f32,
     speedMult: f32,
-    _pad2: vec3<f32>,
+    breath: f32,
 };
 
 @group(0) @binding(0) var<uniform> u: VIB3Uniforms;
@@ -52,8 +54,8 @@ fn rotateXY(angle: f32) -> mat4x4<f32> {
 fn rotateXZ(angle: f32) -> mat4x4<f32> {
     let c = cos(angle); let s = sin(angle);
     return mat4x4<f32>(
-        vec4<f32>(c, 0.0, -s, 0.0), vec4<f32>(0.0, 1.0, 0.0, 0.0),
-        vec4<f32>(s, 0.0, c, 0.0), vec4<f32>(0.0, 0.0, 0.0, 1.0));
+        vec4<f32>(c, 0.0, s, 0.0), vec4<f32>(0.0, 1.0, 0.0, 0.0),
+        vec4<f32>(-s, 0.0, c, 0.0), vec4<f32>(0.0, 0.0, 0.0, 1.0));
 }
 fn rotateYZ(angle: f32) -> mat4x4<f32> {
     let c = cos(angle); let s = sin(angle);

package/src/testing/ParallelTestFramework.js

@@ -151,8 +151,8 @@ export class ParallelTestFramework {
         // Create system instance based on type
         switch (testSpec.system) {
             case 'faceted':
-                const { VIB34DIntegratedEngine } = await import('../core/Engine.js');
-                testSystem = new VIB34DIntegratedEngine();
+                const { VIB3Engine } = await import('../core/VIB3Engine.js');
+                testSystem = new VIB3Engine();
                 break;
             case 'quantum':
                 const { QuantumEngine } = await import('../quantum/QuantumEngine.js');

package/src/testing/ProjectionClass.test.js

@@ -0,0 +1,38 @@
+import { describe, expect, it } from 'vitest';
+import Projection from '../math/Projection.js';
+import Vec4 from '../math/Vec4.js';
+
+describe('Projection Class', () => {
+    it('should project using perspective', () => {
+        const v = new Vec4(1, 1, 1, 0);
+        const p = Projection.perspective(v, 2);
+        expect(p.x).toBeCloseTo(0.5);
+        expect(p.y).toBeCloseTo(0.5);
+        expect(p.z).toBeCloseTo(0.5);
+        expect(p.w).toBe(0);
+    });
+
+    it('should support target vector in perspective', () => {
+        const v = new Vec4(1, 1, 1, 0);
+        const target = new Vec4();
+        const result = Projection.perspective(v, 2, {}, target);
+        expect(result).toBe(target);
+        expect(target.x).toBeCloseTo(0.5);
+    });
+
+    it('should project array using perspectiveArray', () => {
+        const vectors = [new Vec4(1, 1, 1, 0), new Vec4(2, 2, 2, 0)];
+        const result = Projection.perspectiveArray(vectors, 2);
+        expect(result.length).toBe(2);
+        expect(result[0].x).toBeCloseTo(0.5);
+        expect(result[1].x).toBeCloseTo(1.0);
+    });
+
+    it('should reuse target array in perspectiveArray', () => {
+        const vectors = [new Vec4(1, 1, 1, 0)];
+        const targetArray = [new Vec4()];
+        const result = Projection.perspectiveArray(vectors, 2, {}, targetArray);
+        expect(result).toBe(targetArray);
+        expect(targetArray[0].x).toBeCloseTo(0.5);
+    });
+});

package/src/ui/adaptive/renderers/webgpu/WebGPURenderer.ts

@@ -546,9 +546,9 @@ fn rotateXZ(angle: f32) -> mat4x4<f32> {
     let c = cos(angle);
     let s = sin(angle);
     return mat4x4<f32>(
-        vec4<f32>(c, 0.0, -s, 0.0),
+        vec4<f32>( c, 0.0, s, 0.0),
         vec4<f32>(0.0, 1.0, 0.0, 0.0),
-        vec4<f32>(s, 0.0, c, 0.0),
+        vec4<f32>(-s, 0.0, c, 0.0),
         vec4<f32>(0.0, 0.0, 0.0, 1.0)
     );
 }

package/src/viewer/GalleryUI.js

@@ -749,6 +749,23 @@ export class GalleryUI extends EventEmitter {
         this.render();
     }
 
+    /**
+     * Handle search input
+     */
+    _onSearch(event) {
+        this.searchQuery = event.target.value;
+        this._applyFilters();
+        this.render();
+    }
+
+    /**
+     * Handle page change
+     */
+    _onPageChange(page) {
+        this.currentPage = page;
+        this.render();
+    }
+
     /**
      * Handle variation hover
      */

package/src/viewer/ViewerPortal.js

@@ -185,14 +185,14 @@ export class ViewerPortal extends EventEmitter {
 
     captureFrame(format = 'png', quality = 0.92) {
         if (!this.canvas) return null;
-        return this.canvas.toDataURL(\`image/\${format}\`, quality);
+        return this.canvas.toDataURL(`image/${format}`, quality);
     }
 
     downloadFrame(filename = 'vib3-capture', format = 'png') {
         const dataUrl = this.captureFrame(format);
         if (!dataUrl) return;
         const link = document.createElement('a');
-        link.download = \`\${filename}.\${format}\`;
+        link.download = `${filename}.${format}`;
         link.href = dataUrl;
         link.click();
     }

package/tools/shader-sync-verify.js

@@ -602,6 +602,7 @@ const FACETED_GLSL_FRAGMENT = `
 precision highp float;
 uniform float u_time;
 uniform vec2 u_resolution;
+uniform vec2 u_mouse;
 uniform float u_geometry;
 uniform float u_rot4dXY;
 uniform float u_rot4dXZ;
@@ -619,6 +620,7 @@ uniform float u_saturation;
 uniform float u_speed;
 uniform float u_mouseIntensity;
 uniform float u_clickIntensity;
+uniform float u_roleIntensity;
 uniform float u_bass;
 uniform float u_mid;
 uniform float u_high;
@@ -667,7 +669,8 @@ struct VIB3Uniforms {
 
 /**
  * Holographic system GLSL fragment shader uniforms (from HolographicVisualizer.js).
- * This system uses non-standard names for several uniforms.
+ * Uses standard names (u_gridDensity, u_morphFactor, u_geometry) plus many
+ * system-specific uniforms for audio/touch/scroll reactivity.
  */
 const HOLOGRAPHIC_GLSL_FRAGMENT = `
 precision highp float;
@@ -675,7 +678,7 @@ uniform vec2 u_resolution;
 uniform float u_time;
 uniform vec2 u_mouse;
 uniform float u_geometry;
-uniform float u_density;
+uniform float u_gridDensity;
 uniform float u_speed;
 uniform vec3 u_color;
 uniform float u_intensity;
@@ -686,9 +689,8 @@ uniform float u_chaosIntensity;
 uniform float u_mouseIntensity;
 uniform float u_clickIntensity;
 uniform float u_densityVariation;
-uniform float u_geometryType;
 uniform float u_chaos;
-uniform float u_morph;
+uniform float u_morphFactor;
 uniform float u_touchMorph;
 uniform float u_touchChaos;
 uniform float u_scrollParallax;

package/tools/update_projection.py

@@ -0,0 +1,109 @@
+import re
+
+file_path = 'src/math/Projection.js'
+
+with open(file_path, 'r') as f:
+    content = f.read()
+
+# Replace perspective JSDoc and Implementation
+perspective_old = r"""     * @param {Vec4} v - 4D point
+     * @param {number} d - Distance parameter (typically 1.5-5)
+     * @returns {Vec4} Projected point (w=0)
+     */
+    static perspective(v, d = 2, options = {}) {
+        if (typeof d === 'object') {
+            options = d;
+            d = options.d ?? 2;
+        }
+        const epsilon = options.epsilon ?? DEFAULT_EPSILON;
+        const denom = clampDenominator(d - v.w, epsilon);
+        const scale = 1 / denom;
+        return new Vec4(v.x * scale, v.y * scale, v.z * scale, 0);
+    }"""
+
+perspective_new = r"""     * @param {Vec4} v - 4D point
+     * @param {number} d - Distance parameter (typically 1.5-5)
+     * @param {object} [options] - Projection options
+     * @param {Vec4} [target] - Optional target vector to write result to
+     * @returns {Vec4} Projected point (w=0)
+     */
+    static perspective(v, d = 2, options = {}, target = null) {
+        if (typeof d === 'object') {
+            options = d;
+            d = options.d ?? 2;
+        }
+
+        // Handle options overload or direct target argument
+        if (!target && options && options.target) {
+            target = options.target;
+        }
+
+        const epsilon = (options && options.epsilon) ?? DEFAULT_EPSILON;
+        const denom = clampDenominator(d - v.w, epsilon);
+        const scale = 1 / denom;
+
+        if (target) {
+            return target.set(v.x * scale, v.y * scale, v.z * scale, 0);
+        }
+        return new Vec4(v.x * scale, v.y * scale, v.z * scale, 0);
+    }"""
+
+if perspective_old in content:
+    content = content.replace(perspective_old, perspective_new)
+else:
+    print("Could not find perspective implementation to replace.")
+    # Attempt more robust search if exact match fails? No, simpler is safer for now.
+
+# Replace perspectiveArray JSDoc and Implementation
+perspective_array_old = r"""    /**
+     * Project array of Vec4s using perspective projection
+     * @param {Vec4[]} vectors
+     * @param {number} d
+     * @returns {Vec4[]}
+     */
+    static perspectiveArray(vectors, d = 2, options = {}) {
+        return vectors.map(v => Projection.perspective(v, d, options));
+    }"""
+
+perspective_array_new = r"""    /**
+     * Project array of Vec4s using perspective projection
+     * @param {Vec4[]} vectors
+     * @param {number} d
+     * @param {object} [options]
+     * @param {Vec4[]} [target] - Optional target array to write results to
+     * @returns {Vec4[]}
+     */
+    static perspectiveArray(vectors, d = 2, options = {}, target = null) {
+        // Handle options overload for 'd'
+        if (typeof d === 'object') {
+             options = d;
+             d = options.d ?? 2;
+        }
+
+        if (!target) {
+            return vectors.map(v => Projection.perspective(v, d, options));
+        }
+
+        const count = vectors.length;
+        // Iterate and reuse
+        for (let i = 0; i < count; i++) {
+            const out = target[i];
+            if (out) {
+                Projection.perspective(vectors[i], d, options, out);
+            } else {
+                target[i] = Projection.perspective(vectors[i], d, options);
+            }
+        }
+
+        return target;
+    }"""
+
+if perspective_array_old in content:
+    content = content.replace(perspective_array_old, perspective_array_new)
+else:
+    print("Could not find perspectiveArray implementation to replace.")
+
+with open(file_path, 'w') as f:
+    f.write(content)
+
+print("Updated Projection.js")