@buley/hexgrid-3d 1.0.0 → 1.1.1

package/src/types.ts

@@ -2,68 +2,69 @@
  * Type definitions for HexGrid Visualization
  */
 
-import type { RefObject } from 'react'
-import type { HexGridFeatureFlags } from './features'
+import type { RefObject } from 'react';
+import type { HexGridFeatureFlags } from './features';
+export type { HexGridFeatureFlags } from './features';
 
 /**
  * Photo type for HexGrid visualization
- * 
+ *
  * This is the unified Photo type used throughout the hexgrid-3d package.
  * It includes all fields needed for display, media playback, and analytics.
  */
 export interface Photo {
-  id: string
-  title: string
-  
+  id: string;
+  title: string;
+
   // Image URLs - imageUrl is primary, url is for backward compatibility
-  imageUrl: string
-  url?: string  // Alias for imageUrl (backward compatibility)
-  thumbnailUrl?: string
-  
+  imageUrl: string;
+  url?: string; // Alias for imageUrl (backward compatibility)
+  thumbnailUrl?: string;
+
   // Display metadata
-  alt: string
-  category: string
-  description?: string
-  
+  alt: string;
+  category: string;
+  description?: string;
+
   // Source information
-  source: string
-  sourceUrl?: string
-  createdAt?: string
-  
+  source: string;
+  sourceUrl?: string;
+  createdAt?: string;
+
   // Shop integration
-  shopUrl?: string
-  location?: string
-  
+  shopUrl?: string;
+  location?: string;
+
   // Media type flags
-  isVideo?: boolean
-  videoUrl?: string
-  isTweet?: boolean
-  tweetUrl?: string
-  redditUrl?: string
-  durationSeconds?: number
-  
+  isVideo?: boolean;
+  videoUrl?: string;
+  isTweet?: boolean;
+  tweetUrl?: string;
+  redditUrl?: string;
+  durationSeconds?: number;
+
   // Competition/ranking system
-  velocity?: number  // Normalized velocity [0.1, 1.0] for meritocratic competition
-  
+  velocity?: number; // Normalized velocity [0.1, 1.0] for meritocratic competition
+
   // User info
-  userId?: string
-  username?: string
-  platform?: string
-  author?: string
-  authorUrl?: string
-  
+  userId?: string;
+  username?: string;
+  platform?: string;
+  author?: string;
+  authorUrl?: string;
+
   // Metrics for analytics
-  views?: number
-  likes?: number
-  comments?: number
-  shares?: number
-  upvotes?: number
-  retweets?: number
-  replies?: number
-  age_in_hours?: number
-  
+  views?: number;
+  likes?: number;
+  comments?: number;
+  shares?: number;
+  upvotes?: number;
+  retweets?: number;
+  replies?: number;
+  age_in_hours?: number;
+
   // Visual
-  dominantColor?: string
+  dominantColor?: string;
 }
 
 /**
@@ -72,81 +73,92 @@ export interface Photo {
  */
 export interface GridItem<T = unknown> {
   // Core identification
-  id: string
-  type: string // 'photo' | 'note' | 'emotion' | 'ontology-entity' | 'custom'
+  id: string;
+  type: string; // 'photo' | 'note' | 'emotion' | 'ontology-entity' | 'custom'
 
   // Visual representation (optional - allows non-visual items)
-  imageUrl?: string
-  thumbnailUrl?: string
-  videoUrl?: string
+  imageUrl?: string;
+  thumbnailUrl?: string;
+  videoUrl?: string;
 
   // Display metadata
-  title?: string
-  alt?: string
-  description?: string
-  category?: string
+  title?: string;
+  alt?: string;
+  description?: string;
+  category?: string;
 
   // Embedded data object (preserves original type)
-  data?: T
+  data?: T;
 
   // Ontology metadata (optional, for ontology-aware items)
   ontologyMetadata?: {
-    entityId?: string
-    entityType?: string | string[]
-    properties?: Record<string, unknown>
+    entityId?: string;
+    entityType?: string | string[];
+    properties?: Record<string, unknown>;
     provenance?: {
-      source: string
-      extractedAt: string
-      confidence: number
-    }
-  }
+      source: string;
+      extractedAt: string;
+      confidence: number;
+    };
+  };
 
   // Grid behavior
-  velocity?: number
-  source?: string
-  sourceUrl?: string
-  createdAt?: string
+  velocity?: number;
+  source?: string;
+  sourceUrl?: string;
+  createdAt?: string;
 
   // Metrics (flexible for any data type)
-  metrics?: Record<string, number>
+  metrics?: Record<string, number>;
 
   // Legacy Photo fields (for backward compatibility)
-  url?: string // Maps to imageUrl
-  userId?: string
-  username?: string
-  platform?: string
-  author?: string
-  authorUrl?: string
-  likes?: number
-  views?: number
-  comments?: number
-  dominantColor?: string
+  url?: string; // Maps to imageUrl
+  userId?: string;
+  username?: string;
+  platform?: string;
+  author?: string;
+  authorUrl?: string;
+  likes?: number;
+  views?: number;
+  comments?: number;
+  dominantColor?: string;
 }
 
 export interface HexGridProps {
-  photos: Photo[]
-  onHexClick?: (photo: Photo) => void
-  spacing?: number
-  canvasRef?: RefObject<HTMLCanvasElement>
-  onLeaderboardUpdate?: (leaderboard: any) => void
-  autoplayQueueLimit?: number
-  onAutoplayQueueLimitChange?: (limit: number) => void
-  modalOpen?: boolean
-  userId?: string
-  username?: string
-  featureFlags?: HexGridFeatureFlags
+  photos: Photo[];
+  onHexClick?: (photo: Photo) => void;
+  spacing?: number;
+  canvasRef?: RefObject<HTMLCanvasElement>;
+  onLeaderboardUpdate?: (leaderboard: any) => void;
+  autoplayQueueLimit?: number;
+  onAutoplayQueueLimitChange?: (limit: number) => void;
+  modalOpen?: boolean;
+  userId?: string;
+  username?: string;
+  featureFlags?: HexGridFeatureFlags;
+  enableEnhanced?: boolean;
+  enhancedConfig?: {
+    useWasm?: boolean;
+    enableParticles?: boolean;
+    enableFlowField?: boolean;
+  };
+  onTerritoryEvent?: (event: {
+    type: 'conquest' | 'birth' | 'death';
+    toOwner: number;
+    fromOwner?: number;
+  }) => Promise<void>;
 }
 
 export interface UIState {
-  debugOpen: boolean
-  showStats: boolean
-  cameraOpen: boolean
-  showNarration: boolean
+  debugOpen: boolean;
+  showStats: boolean;
+  cameraOpen: boolean;
+  showNarration: boolean;
 }
 
 export interface WorkerDebug {
-  curveUDeg: number
-  curveVDeg: number
-  batchPerFrame: number
-  [key: string]: any
+  curveUDeg: number;
+  curveVDeg: number;
+  batchPerFrame: number;
+  [key: string]: any;
 }

package/src/utils/image-utils.ts

@@ -12,14 +12,17 @@
  */
 export function getProxiedImageUrl(imageUrl: string): string {
   if (!imageUrl || typeof imageUrl !== 'string') {
-    return imageUrl
+    return imageUrl;
   }
-  
+
   // Only proxy preview.redd.it URLs (they have CORS issues)
   // external-preview.redd.it URLs work fine, so don't proxy them
-  if (imageUrl.includes('preview.redd.it') && !imageUrl.includes('external-preview.redd.it')) {
-    return `/api/proxy-image?url=${encodeURIComponent(imageUrl)}`
+  if (
+    imageUrl.includes('preview.redd.it') &&
+    !imageUrl.includes('external-preview.redd.it')
+  ) {
+    return `/api/proxy-image?url=${encodeURIComponent(imageUrl)}`;
   }
-  
-  return imageUrl
+
+  return imageUrl;
 }