@buley/hexgrid-3d 1.0.0 → 1.1.1

package/src/math/Matrix4.ts

@@ -8,21 +8,11 @@ export class Matrix4 {
   }
 
   static identity(): Matrix4 {
-    return new Matrix4([
-      1, 0, 0, 0,
-      0, 1, 0, 0,
-      0, 0, 1, 0,
-      0, 0, 0, 1,
-    ]);
+    return new Matrix4([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]);
   }
 
   static translation(x: number, y: number, z: number): Matrix4 {
-    return new Matrix4([
-      1, 0, 0, x,
-      0, 1, 0, y,
-      0, 0, 1, z,
-      0, 0, 0, 1,
-    ]);
+    return new Matrix4([1, 0, 0, x, 0, 1, 0, y, 0, 0, 1, z, 0, 0, 0, 1]);
   }
 
   transformPoint(point: Vector3): Vector3 {

package/src/math/Vector3.ts

@@ -49,7 +49,11 @@ export class Vector3 {
     this.z = z;
   }
 
-  static fromLatLng(latitude: number, longitude: number, radius: number = 1): Vector3 {
+  static fromLatLng(
+    latitude: number,
+    longitude: number,
+    radius: number = 1
+  ): Vector3 {
     const latRad = (latitude * Math.PI) / 180;
     const lonRad = (longitude * Math.PI) / 180;
 
@@ -60,6 +64,50 @@ export class Vector3 {
     return new Vector3(x, y, z);
   }
 
+  clone(): Vector3 {
+    return new Vector3(this.x, this.y, this.z);
+  }
+
+  add(other: Vector3): Vector3 {
+    return new Vector3(this.x + other.x, this.y + other.y, this.z + other.z);
+  }
+
+  subtract(other: Vector3): Vector3 {
+    return new Vector3(this.x - other.x, this.y - other.y, this.z - other.z);
+  }
+
+  scale(factor: number): Vector3 {
+    return new Vector3(this.x * factor, this.y * factor, this.z * factor);
+  }
+
+  dot(other: Vector3): number {
+    return this.x * other.x + this.y * other.y + this.z * other.z;
+  }
+
+  cross(other: Vector3): Vector3 {
+    return new Vector3(
+      this.y * other.z - this.z * other.y,
+      this.z * other.x - this.x * other.z,
+      this.x * other.y - this.y * other.x
+    );
+  }
+
+  length(): number {
+    return Math.sqrt(this.x * this.x + this.y * this.y + this.z * this.z);
+  }
+
+  magnitude(): number {
+    return this.length();
+  }
+
+  normalize(): Vector3 {
+    const len = this.length();
+    if (len === 0) {
+      return new Vector3(0, 0, 0);
+    }
+    return new Vector3(this.x / len, this.y / len, this.z / len);
+  }
+
   distanceTo(other: Vector3): number {
     const dx = this.x - other.x;
     const dy = this.y - other.y;

package/src/math/index.ts

@@ -1,11 +1,11 @@
 /**
  * Math Module Exports
- * 
+ *
  * @module math
  */
 
-export * from './Vector3'
-export * from './Matrix4'
-export * from './Quaternion'
-export * from './HexCoordinates'
-export * from './SpatialIndex'
+export * from './Vector3';
+export * from './Matrix4';
+export * from './Quaternion';
+export * from './HexCoordinates';
+export * from './SpatialIndex';

package/src/note-adapter.ts

@@ -1,53 +1,53 @@
 /**
  * Adapter for embedding notes directly in the grid
- * 
+ *
  * This adapter allows notes (Cyrano's internal notes, user notes, etc.)
  * to be embedded directly in GridItems with full metadata preservation.
  */
 
-import type { GridItem } from './types'
-import type { ItemAdapter, AdapterOptions } from './adapters'
+import type { GridItem } from './types';
+import type { ItemAdapter, AdapterOptions } from './adapters';
 
 /**
  * Note content structure
  */
 export interface NoteContent {
-  title?: string
-  text: string
-  summary?: string
+  title?: string;
+  text: string;
+  summary?: string;
 }
 
 /**
  * Note metadata structure
  */
 export interface NoteMetadata {
-  type?: string
-  category?: string
-  subcategory?: string
-  tags?: string[]
-  targetUserId?: string
-  status?: 'active' | 'archived' | 'draft'
-  priority?: 'low' | 'medium' | 'high' | 'urgent'
-  context?: string
-  permissions?: 'private' | 'shared' | 'public'
-  sharedWith?: string[]
+  type?: string;
+  category?: string;
+  subcategory?: string;
+  tags?: string[];
+  targetUserId?: string;
+  status?: 'active' | 'archived' | 'draft';
+  priority?: 'low' | 'medium' | 'high' | 'urgent';
+  context?: string;
+  permissions?: 'private' | 'shared' | 'public';
+  sharedWith?: string[];
 }
 
 /**
  * Note structure matching Affectively's note format
  */
 export interface Note {
-  id: string
-  content: NoteContent
-  metadata?: NoteMetadata
-  date: string
+  id: string;
+  content: NoteContent;
+  metadata?: NoteMetadata;
+  date: string;
 }
 
 /**
  * Calculate velocity for a note based on recency, priority, and metadata richness
  */
 function calculateNoteVelocity(note: Note): number {
-  let velocity = 0.1 // Base minimum
+  let velocity = 0.1; // Base minimum
 
   // Priority contribution (0-0.3)
   const priorityMap: Record<string, number> = {
@@ -55,29 +55,30 @@ function calculateNoteVelocity(note: Note): number {
     high: 0.2,
     medium: 0.1,
     low: 0.05,
-  }
+  };
   if (note.metadata?.priority) {
-    velocity += priorityMap[note.metadata.priority] || 0.1
+    velocity += priorityMap[note.metadata.priority] || 0.1;
   }
 
   // Recency contribution (0-0.4)
   if (note.date) {
-    const ageMs = Date.now() - new Date(note.date).getTime()
-    const ageHours = ageMs / (1000 * 60 * 60)
-    const recencyFactor = Math.max(0, 1 - ageHours / 168) // Decay over 1 week
-    velocity += recencyFactor * 0.4
+    const ageMs = Date.now() - new Date(note.date).getTime();
+    const ageHours = ageMs / (1000 * 60 * 60);
+    const recencyFactor = Math.max(0, 1 - ageHours / 168); // Decay over 1 week
+    velocity += recencyFactor * 0.4;
   }
 
   // Metadata richness contribution (0-0.2)
-  let contextScore = 0
-  if (note.metadata?.type) contextScore += 0.05
-  if (note.metadata?.category) contextScore += 0.05
-  if (note.metadata?.tags && note.metadata.tags.length > 0) contextScore += 0.05
-  if (note.metadata?.context) contextScore += 0.05
-  velocity += Math.min(contextScore, 0.2)
+  let contextScore = 0;
+  if (note.metadata?.type) contextScore += 0.05;
+  if (note.metadata?.category) contextScore += 0.05;
+  if (note.metadata?.tags && note.metadata.tags.length > 0)
+    contextScore += 0.05;
+  if (note.metadata?.context) contextScore += 0.05;
+  velocity += Math.min(contextScore, 0.2);
 
   // Clamp to [0.1, 1.0]
-  return Math.max(0.1, Math.min(1.0, velocity))
+  return Math.max(0.1, Math.min(1.0, velocity));
 }
 
 /**
@@ -85,7 +86,7 @@ function calculateNoteVelocity(note: Note): number {
  */
 export const noteAdapter: ItemAdapter<Note> = {
   toGridItem(note: Note, options?: AdapterOptions): GridItem<Note> {
-    const velocity = options?.velocity ?? calculateNoteVelocity(note)
+    const velocity = options?.velocity ?? calculateNoteVelocity(note);
 
     return {
       id: note.id,
@@ -100,25 +101,32 @@ export const noteAdapter: ItemAdapter<Note> = {
       category: note.metadata?.category,
       // Store metadata in metrics for filtering/sorting
       metrics: {
-        priority: note.metadata?.priority === 'urgent' ? 4 : note.metadata?.priority === 'high' ? 3 : note.metadata?.priority === 'medium' ? 2 : 1,
+        priority:
+          note.metadata?.priority === 'urgent'
+            ? 4
+            : note.metadata?.priority === 'high'
+            ? 3
+            : note.metadata?.priority === 'medium'
+            ? 2
+            : 1,
         tagCount: note.metadata?.tags?.length || 0,
       },
-    }
+    };
   },
 
   fromGridItem(item: GridItem<Note>): Note {
     if (!item.data) {
-      throw new Error('GridItem missing note data')
+      throw new Error('GridItem missing note data');
     }
-    return item.data
+    return item.data;
   },
 
   calculateVelocity(note: Note): number {
-    return calculateNoteVelocity(note)
+    return calculateNoteVelocity(note);
   },
 
   extractVisualUrl(note: Note): string | undefined {
     // Notes can have generated visualizations
-    return `/api/notes/${note.id}/visualization`
+    return `/api/notes/${note.id}/visualization`;
   },
-}
+};

package/src/ontology-adapter.ts

@@ -1,49 +1,53 @@
 /**
  * Adapter for embedding ontology entities directly in the grid
- * 
+ *
  * This adapter allows ontology entities from @emotions-app/shared-utils/ontology
  * to be embedded directly in GridItems with full metadata preservation.
  */
 
-import type { OntologyEntity } from '@emotions-app/shared-utils/ontology/types'
-import type { GridItem } from './types'
-import type { ItemAdapter, AdapterOptions } from './adapters'
+import type { OntologyEntity } from '@emotions-app/shared-utils/ontology/types';
+import type { GridItem } from './types';
+import type { ItemAdapter, AdapterOptions } from './adapters';
 
 /**
  * Calculate velocity for an ontology entity based on provenance confidence
  * and recency
  */
 function calculateEntityVelocity(entity: OntologyEntity): number {
-  let velocity = 0.1 // Base minimum
+  let velocity = 0.1; // Base minimum
 
   // Use provenance confidence (0-1) as primary factor
-  const confidence = entity.metadata.provenance.confidence
-  velocity += confidence * 0.5
+  const confidence = entity.metadata.provenance.confidence;
+  velocity += confidence * 0.5;
 
   // Recency factor based on lastModified
   if (entity.metadata.lastModified) {
-    const ageMs = Date.now() - new Date(entity.metadata.lastModified).getTime()
-    const ageHours = ageMs / (1000 * 60 * 60)
-    const recencyFactor = Math.max(0, 1 - ageHours / 168) // Decay over 1 week
-    velocity += recencyFactor * 0.4
+    const ageMs = Date.now() - new Date(entity.metadata.lastModified).getTime();
+    const ageHours = ageMs / (1000 * 60 * 60);
+    const recencyFactor = Math.max(0, 1 - ageHours / 168); // Decay over 1 week
+    velocity += recencyFactor * 0.4;
   }
 
   // Clamp to [0.1, 1.0]
-  return Math.max(0.1, Math.min(1.0, velocity))
+  return Math.max(0.1, Math.min(1.0, velocity));
 }
 
 /**
  * Adapter for embedding ontology entities directly
  */
 export const ontologyEntityAdapter: ItemAdapter<OntologyEntity> = {
-  toGridItem(entity: OntologyEntity, options?: AdapterOptions): GridItem<OntologyEntity> {
-    const velocity = options?.velocity ?? calculateEntityVelocity(entity)
+  toGridItem(
+    entity: OntologyEntity,
+    options?: AdapterOptions
+  ): GridItem<OntologyEntity> {
+    const velocity = options?.velocity ?? calculateEntityVelocity(entity);
 
     return {
       id: entity['@id'],
       type: 'ontology-entity',
       title: entity.label,
-      description: (entity.properties.description as string | undefined) || entity.label,
+      description:
+        (entity.properties.description as string | undefined) || entity.label,
       data: entity,
       ontologyMetadata: {
         entityId: entity['@id'],
@@ -54,24 +58,27 @@ export const ontologyEntityAdapter: ItemAdapter<OntologyEntity> = {
         provenance: entity.metadata.provenance,
       },
       velocity,
-      createdAt: entity.metadata.lastModified || entity.metadata.provenance.extractedAt,
+      createdAt:
+        entity.metadata.lastModified || entity.metadata.provenance.extractedAt,
       // Extract visual URL if available in properties
-      imageUrl: options?.visualUrl || (entity.properties.imageUrl as string | undefined),
-    }
+      imageUrl:
+        options?.visualUrl ||
+        (entity.properties.imageUrl as string | undefined),
+    };
   },
 
   fromGridItem(item: GridItem<OntologyEntity>): OntologyEntity {
     if (!item.data) {
-      throw new Error('GridItem missing ontology entity data')
+      throw new Error('GridItem missing ontology entity data');
     }
-    return item.data
+    return item.data;
   },
 
   calculateVelocity(entity: OntologyEntity): number {
-    return calculateEntityVelocity(entity)
+    return calculateEntityVelocity(entity);
   },
 
   extractVisualUrl(entity: OntologyEntity): string | undefined {
-    return entity.properties.imageUrl as string | undefined
+    return entity.properties.imageUrl as string | undefined;
   },
-}
+};

package/src/stores/uiStore.ts

@@ -1,85 +1,85 @@
 type UIState = {
-  debugOpen: boolean
-  showStats: boolean
-  cameraOpen?: boolean
-  showNarration?: boolean
-}
+  debugOpen: boolean;
+  showStats: boolean;
+  cameraOpen?: boolean;
+  showNarration?: boolean;
+};
 
 // Safe localStorage helpers that never throw
 const safeGetItem = (key: string): string | null => {
   // istanbul ignore next
-  if (typeof window === 'undefined') return null
+  if (typeof window === 'undefined') return null;
   try {
-    return window.localStorage.getItem(key)
+    return window.localStorage.getItem(key);
   } catch {
     // istanbul ignore next
-    return null
+    return null;
   }
-}
+};
 
 const safeSetItem = (key: string, value: string): void => {
   // istanbul ignore next
-  if (typeof window === 'undefined') return
+  if (typeof window === 'undefined') return;
   try {
-    window.localStorage.setItem(key, value)
+    window.localStorage.setItem(key, value);
   } catch {
     // istanbul ignore next - private browsing, quota exceeded
   }
-}
+};
 
 // Initialize showNarration from localStorage if available
-const savedNarration = safeGetItem('hexgrid.showNarration')
-const initialShowNarration = savedNarration === 'true'
+const savedNarration = safeGetItem('hexgrid.showNarration');
+const initialShowNarration = savedNarration === 'true';
 
 const state: UIState = {
   debugOpen: false,
   showStats: false,
   cameraOpen: false,
-  showNarration: initialShowNarration
-}
+  showNarration: initialShowNarration,
+};
 
-const listeners = new Set<(s: UIState) => void>()
+const listeners = new Set<(s: UIState) => void>();
 
 const uiStore = {
   getState(): UIState {
-    return { ...state }
+    return { ...state };
   },
   set(partial: Partial<UIState>) {
-    let changed = false
+    let changed = false;
     for (const k of Object.keys(partial) as (keyof UIState)[]) {
       if (partial[k] !== undefined && state[k] !== partial[k]) {
         // @ts-ignore
-        state[k] = partial[k]
-        changed = true
+        state[k] = partial[k];
+        changed = true;
       }
     }
     if (changed) {
       // Persist showNarration to localStorage for cross-refresh consistency
       if (partial.showNarration !== undefined) {
-        safeSetItem('hexgrid.showNarration', String(!!partial.showNarration))
+        safeSetItem('hexgrid.showNarration', String(!!partial.showNarration));
       }
-      for (const cb of Array.from(listeners)) cb({ ...state })
+      for (const cb of Array.from(listeners)) cb({ ...state });
     }
   },
   subscribe(cb: (s: UIState) => void) {
-    listeners.add(cb)
+    listeners.add(cb);
     // emit current immediately
-    cb({ ...state })
-    return () => listeners.delete(cb)
+    cb({ ...state });
+    return () => listeners.delete(cb);
   },
   toggleDebug() {
-    this.set({ debugOpen: !state.debugOpen })
+    this.set({ debugOpen: !state.debugOpen });
   },
   toggleStats() {
-    this.set({ showStats: !state.showStats })
+    this.set({ showStats: !state.showStats });
   },
   toggleCamera() {
-    this.set({ cameraOpen: !state.cameraOpen })
+    this.set({ cameraOpen: !state.cameraOpen });
   },
   toggleNarration() {
-    this.set({ showNarration: !state.showNarration })
-  }
-}
+    this.set({ showNarration: !state.showNarration });
+  },
+};
 
-export { uiStore }
-export default uiStore
+export { uiStore };
+export default uiStore;

package/src/types/shared-utils.d.ts

@@ -0,0 +1,10 @@
+declare module '@emotions-app/shared-utils/ontology/types' {
+    export interface OntologyType {
+        [key: string]: any;
+    }
+    export interface OntologyEntity {
+        id: string;
+        type: string;
+        [key: string]: any;
+    }
+}