@buley/hexgrid-3d 1.1.0 → 1.1.1

package/src/adapters/DashAdapter.ts

@@ -0,0 +1,57 @@
+/**
+ * Adapter for Zero-Copy Data Sync between Dash 2.0 and HexGrid-3D.
+ * 
+ * This adapter subscribes to a Dash "LiveQuery" which returns pointers to shared memory (SharedArrayBuffer)
+ * or Float32Arrays. It then syncs this data directly to the HexGridWasm instance.
+ */
+
+// Placeholder types until we link the actual Dash package
+interface DashQueryHandle {
+  ptr: number;
+  size: number;
+  buffer: SharedArrayBuffer | ArrayBuffer;
+}
+
+export class DashAdapter {
+  private dash: any; // Will be typed when we link @buley/dash
+
+  constructor(dashInstance: any) {
+    this.dash = dashInstance;
+  }
+
+  /**
+   * Subscribe to a semantic query in Dash and sync results to HexGrid.
+   * 
+   * @param query The vector search query
+   * @param gridInstance The WASM instance of the HexGrid
+   */
+  bindSemanticSearch(query: string, particleSystem: any) {
+    console.log('[DashAdapter] Binding semantic search:', query);
+    
+    // Hypothetical Zero-Copy API from Dash 2.0
+    if (this.dash.liveQueryPtr) {
+       this.dash.liveQueryPtr(`SELECT embedding FROM dash_vec_idx WHERE embedding MATCH '${query}'`).subscribe((handle: DashQueryHandle) => {
+          console.log(`[DashAdapter] Received ${handle.size} bytes from Dash.`);
+          
+          // Assume the handle.buffer contains [pos, color, scale] interleaved or tightly packed
+          // For this MVP, we treat it as just positions
+          const floatView = new Float32Array(handle.buffer);
+          
+          // Zero-Copy Injection logic would go here
+          // We can't strictly "inject" one buffer into 3 separate Float32Arrays unless they are contiguous in the SAB
+          // or we create views into offsets.
+          
+          // Hypothetical offset logic:
+          const count = handle.size / 4 / 7; // pos + color + scale = 3+3+1 = 7 floats
+          
+          // particleSystem.setSharedBuffers({
+          //     positions: floatView.subarray(0, count * 3),
+          //     colors: floatView.subarray(count * 3, count * 6),
+          //     scales: floatView.subarray(count * 6, count * 7)
+          // });
+       });
+    } else {
+       console.warn('[DashAdapter] Dash instance does not support Zero-Copy liveQueryPtr yet.');
+    }
+  }
+}

package/src/algorithms/ParticleSystem3D.ts

@@ -88,6 +88,12 @@ export interface ParticleSystem3DConfig {
   boundsCenter?: Vector3;
   /** Bounce factor when hitting bounds (0 = absorb, 1 = perfect bounce) */
   bounceFactor?: number;
+  /** Zero-copy shared buffers */
+  sharedBuffers?: {
+      positions: Float32Array;
+      colors: Float32Array;
+      scales: Float32Array;
+  };
 }
 
 /**
@@ -134,10 +140,25 @@ export class ParticleSystem3D {
     this.boundsCenter = config.boundsCenter ?? new Vector3(0, 0, 0);
     this.bounceFactor = config.bounceFactor ?? 0.5;
 
-    // Pre-allocate buffers
-    this.positionBuffer = new Float32Array(this.maxParticles * 3);
-    this.colorBuffer = new Float32Array(this.maxParticles * 3);
-    this.scaleBuffer = new Float32Array(this.maxParticles);
+    // Pre-allocate buffers (unless provided via config for zero-copy)
+    if (config.sharedBuffers) {
+        this.positionBuffer = config.sharedBuffers.positions;
+        this.colorBuffer = config.sharedBuffers.colors;
+        this.scaleBuffer = config.sharedBuffers.scales;
+    } else {
+        this.positionBuffer = new Float32Array(this.maxParticles * 3);
+        this.colorBuffer = new Float32Array(this.maxParticles * 3);
+        this.scaleBuffer = new Float32Array(this.maxParticles);
+    }
+  }
+
+  /**
+   * Zero-Copy Binding: Inject shared buffers from WASM/Dash
+   */
+  setSharedBuffers(buffers: { positions: Float32Array, colors: Float32Array, scales: Float32Array }) {
+      this.positionBuffer = buffers.positions;
+      this.colorBuffer = buffers.colors;
+      this.scaleBuffer = buffers.scales;
   }
 
   /**

package/src/components/NarrationOverlay.tsx

@@ -197,7 +197,7 @@ export const NarrationOverlay: React.FC<NarrationOverlayProps> = ({
               borderRadius: 4,
             }}
           >
-            {leaderboard.map((entry, i) => (
+            {leaderboard.map((entry: any, i: number) => (
               <div
                 key={entry.photoId}
                 style={{

package/src/lib/narration.ts

@@ -0,0 +1,17 @@
+export interface NarrationMessage {
+  generation: number;
+  timestamp: string;
+  priority: number;
+  text: string;
+  eventType?: string;
+  sparkline?: string;
+}
+
+export class NarrationManager {
+  static getInstance(): any {
+    return {
+      subscribe: () => () => {},
+      getState: () => ({})
+    };
+  }
+}

package/src/lib/stats-tracker.ts

@@ -0,0 +1,25 @@
+export class StatsTracker {
+  static getInstance(): StatsTracker {
+    return new StatsTracker();
+  }
+
+  getCurrentStats(): any {
+    return {
+      generation: 1,
+      activeMemesCount: 10,
+      totalHexesInfected: 100,
+      populationStability: 0.5
+    };
+  }
+
+  getAllTimeRecords(): any {
+    return {
+      highestTerritory: { value: 100 },
+      longestSurvivalStreak: { value: 50 }
+    };
+  }
+
+  getLeaderboard(limit: number): any[] {
+    return [];
+  }
+}

package/src/lib/theme-colors.ts

@@ -0,0 +1,12 @@
+export const ThemeColors = {
+  primary: '#000000',
+  secondary: '#ffffff'
+};
+
+export function getAccentRgba(alpha: number = 1): string {
+  return `rgba(0, 255, 255, ${alpha})`;
+}
+
+export function getAccentHex(): string {
+  return '#00ffff';
+}