@vib3code/sdk 2.0.3-canary.6f35b4c → 2.0.3-canary.74aebb4

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/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/types/adaptive-sdk.d.ts

@@ -5,14 +5,20 @@
  * Barrel re-export for all typed modules.
  *
  * Typed modules:
- *   - core/VIB3Engine (engine, systems, parameters, state)
- *   - core/ErrorReporter (opt-in error capture)
- *   - reactivity (ReactivityManager, ReactivityConfig, all input types)
- *   - reactivity/SpatialInputSystem (universal spatial input)
+ *   - core (VIB3Engine, CanvasManager, ParameterManager, ParameterMapper, VitalitySystem, RendererContracts, UnifiedResourceManager)
+ *   - math (constants, projections, rotations, Vec4)
+ *   - geometry (GeometryLibrary, generators, BufferBuilder)
+ *   - systems (QuantumEngine, FacetedSystem, RealHolographicSystem)
+ *   - scene (ObjectPool, TypedArrayPool, Vec4Pool, PoolManager)
+ *   - viewer (ViewerPortal, ViewerInputHandler, GalleryUI, CardBending, AudioReactivity, TradingCardExporter)
+ *   - variations (VariationManager)
+ *   - reactivity (ReactivityManager, ReactivityConfig, SpatialInputSystem)
  *   - render (WebGL/WebGPU backends, ShaderProgram, RenderState, CommandBuffer)
- *   - creative (ColorPresets, TransitionAnimator, PostProcessing, Timeline)
+ *   - creative (ColorPresets, TransitionAnimator, PostProcessing, Timeline, AestheticMapper, ChoreographyPlayer)
  *   - integrations (React, Vue, Svelte, Figma, Three.js, TouchDesigner, OBS)
  *   - advanced (WebXR, WebGPU Compute, MIDI, AI Presets, OffscreenWorker)
+ *   - export (ExportManager, ShaderExporter, VIB3PackageExporter, TradingCardGenerator)
+ *   - agent (MCPServer, AgentCLI, TelemetryService)
  */
 
 // Core engine
@@ -99,6 +105,37 @@ export {
     Shader4DOptions
 } from './render/index';
 
+// Layer relationship system
+export {
+    LayerRelationshipGraph,
+    RelationshipFn,
+    RelationshipPreset,
+    RelationshipConfig,
+    LayerRelationshipProfile,
+    LayerRelationshipExport,
+    LAYER_ORDER as RENDER_LAYER_ORDER,
+    PRESET_REGISTRY,
+    PROFILES
+} from './render/LayerRelationshipGraph';
+
+// Layer preset manager
+export {
+    LayerPresetManager,
+    LayerPreset,
+    PresetMetadata,
+    PresetLibrary,
+    PresetManagerOptions
+} from './render/LayerPresetManager';
+
+// Layer reactivity bridge
+export {
+    LayerReactivityBridge,
+    ModulationMapping,
+    InputState as LayerInputState,
+    ReactivityBridgeConfig,
+    MODULATION_PROFILES
+} from './render/LayerReactivityBridge';
+
 // Creative tooling
 export {
     ColorPresetsSystem,
@@ -183,3 +220,165 @@ export {
     WorkerSwitchMessage,
     WorkerResizeMessage
 } from './advanced/index';
+
+// Export system
+export {
+    ExportManager,
+    ShaderExporter,
+    VIB3PackageExporter,
+    TradingCardGenerator,
+    TradingCardManager,
+    CardGeneratorBase,
+    FacetedCardGenerator,
+    QuantumCardGenerator,
+    HolographicCardGenerator,
+    TradingCardSystemFaceted,
+    TradingCardSystemHolographic,
+    TradingCardSystemQuantum,
+    VIB3_PACKAGE_VERSION,
+    exportSVG,
+    downloadSVG,
+    exportCSS,
+    downloadCSS,
+    toStyleObject,
+    exportLottie,
+    downloadLottie,
+    createVIB3Package
+} from './export/index';
+
+// Core - expanded types (CanvasManager, Parameters, RendererContracts, etc.)
+export {
+    CanvasManager,
+    CanvasLayer,
+    ParameterManager,
+    ParameterDef,
+    VIB3Parameters,
+    ParameterConfiguration,
+    ParameterMapper,
+    MappableSystem,
+    VitalitySystem,
+    RendererContract,
+    RendererContractAdapter,
+    ResourceManagerContract,
+    FrameState,
+    UnifiedResourceManager
+} from './core/index';
+
+// Math - constants, projections, rotations, Vec4
+export {
+    PI, TAU, HALF_PI, QUARTER_PI,
+    DEG_TO_RAD, RAD_TO_DEG,
+    EPSILON,
+    PHI, PHI_INV,
+    PLANE_NAMES as ROTATION_PLANE_NAMES,
+    encodeGeometry,
+    decodeGeometry,
+    toRadians,
+    toDegrees,
+    clamp,
+    lerp,
+    smoothstep,
+    smootherstep,
+    perspectiveProject4D,
+    stereographicProject4D,
+    ProjectionResult,
+    createRotationMatrix4D,
+    identityMatrix4x4,
+    multiplyMatrix4x4,
+    transposeMatrix4x4,
+    applyMatrix4x4,
+    vectorLength4D,
+    normalizeVector4D,
+    normalizeRotationAngles,
+    composeRotationMatrixFromAngles,
+    RotationPlane,
+    Matrix4x4,
+    Vector4D,
+    Vec4
+} from './math/index';
+
+// Geometry - library, generators, buffers
+export {
+    GeometryLibrary,
+    Geometry4D,
+    VariationParameters,
+    GeometryBuffers,
+    buildVertexBuffer,
+    buildEdgeIndexBuffer,
+    buildFaceIndexBuffer,
+    buildGeometryBuffers,
+    generateTesseract,
+    generateSphere,
+    generateTorus
+} from './geometry/index';
+
+// Visualization systems
+export {
+    QuantumEngine,
+    QuantumEngineOptions,
+    FacetedSystem,
+    FacetedSystemOptions,
+    RealHolographicSystem,
+    HolographicSystemOptions,
+    CanvasSet,
+    AudioData,
+    RenderMode
+} from './systems/index';
+
+// Scene - memory pools
+export {
+    ObjectPool,
+    TypedArrayPool,
+    Vec4Pool,
+    Mat4x4Pool,
+    PoolManager,
+    pools,
+    PoolStats,
+    ObjectPoolOptions
+} from './scene/index';
+
+// Viewer - portal, input, gallery, cards
+export {
+    ViewerPortal,
+    ViewerInputHandler,
+    GalleryUI,
+    CardBending,
+    AudioReactivity as ViewerAudioReactivity,
+    TradingCardExporter,
+    PortalMode,
+    RotationState,
+    InputSource,
+    InputPreset,
+    GalleryViewMode,
+    BendPreset,
+    FrameStyle,
+    RarityLevel
+} from './viewer/index';
+
+// Variations
+export {
+    VariationManager,
+    VariationSlot,
+    VariationOptions
+} from './variations/index';
+
+// Agent system
+export {
+    MCPServer,
+    mcpServer,
+    toolDefinitions,
+    AgentCLI,
+    BatchExecutor,
+    CommandType,
+    ResponseStatus,
+    TelemetryService,
+    TelemetrySpan,
+    EventType,
+    telemetry,
+    EventStreamServer,
+    EventStreamClient,
+    PrometheusExporter,
+    JSONExporter,
+    NDJSONExporter,
+    ConsoleExporter
+} from './agent/index';

package/types/agent/cli.d.ts

@@ -0,0 +1,78 @@
+/**
+ * VIB3+ Agent CLI Type Definitions
+ */
+import { EventEmitter } from 'events';
+
+export declare const CommandType: {
+    SET_PARAMETER: 'set_parameter';
+    GET_PARAMETER: 'get_parameter';
+    SET_GEOMETRY: 'set_geometry';
+    SET_SYSTEM: 'set_system';
+    ROTATE: 'rotate';
+    RESET_ROTATION: 'reset_rotation';
+    BATCH: 'batch';
+    BATCH_ROTATE: 'batch_rotate';
+    GET_METRICS: 'get_metrics';
+    GET_SPANS: 'get_spans';
+    FLUSH_TELEMETRY: 'flush_telemetry';
+    PING: 'ping';
+    STATUS: 'status';
+    HELP: 'help';
+    QUIT: 'quit';
+};
+
+export declare const ResponseStatus: {
+    OK: 'ok';
+    ERROR: 'error';
+    PARTIAL: 'partial';
+};
+
+export interface CLIOptions {
+    inputStream?: NodeJS.ReadableStream;
+    outputStream?: NodeJS.WritableStream;
+    errorStream?: NodeJS.WritableStream;
+    format?: 'jsonl' | 'json' | 'text';
+    pretty?: boolean;
+    enableTelemetry?: boolean;
+}
+
+export interface CLICommand {
+    type: string;
+    id?: string;
+    [key: string]: any;
+}
+
+export interface CLIResponse {
+    id?: string;
+    status: 'ok' | 'error' | 'partial';
+    result?: any;
+    error?: string;
+    durationMs?: number;
+}
+
+export class AgentCLI extends EventEmitter {
+    engine: any;
+    options: CLIOptions;
+    constructor(engine: any, options?: CLIOptions);
+    start(): void;
+    stop(): void;
+    registerHandler(type: string, handler: (command: CLICommand) => any | Promise<any>): void;
+    execute(command: CLICommand): Promise<any>;
+}
+
+export class BatchExecutor {
+    cli: AgentCLI;
+    queue: CLICommand[];
+    results: Array<{ status: string; command: string; result?: any; error?: string }>;
+    constructor(cli: AgentCLI);
+    add(command: CLICommand): this;
+    execute(): Promise<Array<{ status: string; command: string; result?: any; error?: string }>>;
+    executeParallel(): Promise<Array<{ status: string; command: string; result?: any; error?: string }>>;
+}
+
+export interface StreamingCLIResult {
+    cli: AgentCLI;
+    streamServer: any;
+}
+
+export function createStreamingCLI(engine: any, httpServer: any, options?: CLIOptions): StreamingCLIResult;

package/types/agent/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * VIB3+ SDK Agent Module Type Definitions
+ * @module @vib3code/sdk/agent
+ */
+
+// ─── Re-exports ───
+export { MCPServer, mcpServer, toolDefinitions, getToolList, getToolNames, getTool, validateToolInput } from './mcp';
+export { AgentCLI, BatchExecutor, CommandType, ResponseStatus, createStreamingCLI } from './cli';
+export {
+    TelemetryService, TelemetrySpan, EventType, SpanStatus,
+    withTelemetry, withTelemetrySync, telemetry,
+    PrometheusExporter, JSONExporter, NDJSONExporter, ConsoleExporter, createExporter,
+    StreamEventType, EventStreamServer, EventStreamClient, SSEConnection,
+    createSSEHandler, connectTelemetryToStream,
+    configureTelemetry, getTelemetry, trace, traceFunction,
+    traceAsyncIterable, instrumentClass, traceObject, withTiming,
+    meter, traceBatch, TraceContext
+} from './telemetry';