gralobe 1.0.66 → 1.0.68

package/dist/index.d.ts

@@ -174,6 +174,13 @@ export declare class GlobeViz implements GlobeVizAPI {
     private animationId;
     private isDestroyed;
     private urbanPoints;
+    private resizeObserver;
+    private lastContainerWidth;
+    private lastContainerHeight;
+    private hoverTooltip;
+    private currentHoveredFeature;
+    private lastHoverTime;
+    private readonly HOVER_THROTTLE_MS;
     /** Promise that resolves when fully initialized */
     ready: Promise<void>;
     private resolveReady;
@@ -196,9 +203,37 @@ export declare class GlobeViz implements GlobeVizAPI {
     toGlobe(): void;
     toFlat(): void;
     /**
-     * Setup mouse interactions (Click to Zoom, etc.)
+     * Setup mouse interactions (Click to Zoom, Hover, etc.)
      */
     private setupInteraction;
+    /**
+     * Create the hover tooltip element
+     */
+    private createHoverTooltip;
+    /**
+     * Handle hover interactions with throttling for performance
+     */
+    private handleHover;
+    /**
+     * Find feature at given lat/lon using point-in-polygon test
+     */
+    private findFeatureAtLatLon;
+    /**
+     * Check if a point is inside a feature geometry
+     */
+    private isPointInFeature;
+    /**
+     * Ray casting algorithm for point-in-polygon test
+     */
+    private isPointInPolygon;
+    /**
+     * Show hover tooltip at mouse position
+     */
+    private showHoverTooltip;
+    /**
+     * Hide hover tooltip
+     */
+    private hideHoverTooltip;
     setMorph(value: number): void;
     getMorph(): number;
     setStatistic(idOrData: string | StatisticData): void;
@@ -226,6 +261,11 @@ export declare class GlobeViz implements GlobeVizAPI {
     recordGif(options?: ExportOptions): Promise<void>;
     recordVideo(options?: ExportOptions): Promise<void>;
     setEffects(effects: Partial<EffectsConfig>): void;
+    /**
+     * Update hover configuration
+     * @param hover - Partial hover configuration to merge
+     */
+    setHover(hover: Partial<HoverConfig>): void;
     setMarkers(data: MarkerData[], config?: MarkerConfig): void;
     setUrbanData(points: {
         lat: number;
@@ -278,6 +318,8 @@ export declare interface GlobeVizAPI {
     recordVideo(options?: ExportOptions): Promise<void>;
     /** Update effects configuration */
     setEffects(effects: Partial<EffectsConfig>): void;
+    /** Update hover configuration */
+    setHover(hover: Partial<HoverConfig>): void;
     /** Set marker data for city-level visualization */
     setMarkers(data: MarkerData[], config?: MarkerConfig): void;
     /** Set urban city data for visualization */
@@ -427,6 +469,48 @@ export declare interface GlobeVizConfig {
      * Callback for loading progress (0-1)
      */
     onLoadProgress?: (progress: number, status?: string) => void;
+    /**
+     * Callback when hovering over a feature
+     */
+    onHover?: (featureId: string | null, featureName: string | null, value?: number) => void;
+    /**
+     * Hover information configuration
+     */
+    hover?: HoverConfig;
+}
+
+/**
+ * Configuration for hover information display
+ */
+export declare interface HoverConfig {
+    /**
+     * Enable hover information tooltip
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Minimum zoom level (camera distance) for hover to activate.
+     * Value between 0 and 1, where 0 means always show and 1 means only when very close.
+     * Maps to camera distance: 0 = 400 (far), 1 = 50 (close)
+     * @default 0 (always show)
+     */
+    minZoom?: number;
+    /**
+     * Show the feature value in the tooltip (if available)
+     * @default true
+     */
+    showValue?: boolean;
+    /**
+     * Custom tooltip style
+     */
+    style?: {
+        /** Background color */
+        background?: string;
+        /** Text color */
+        color?: string;
+        /** Border color */
+        borderColor?: string;
+    };
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gralobe",
-  "version": "1.0.66",
+  "version": "1.0.68",
   "description": "Interactive 3D globe visualization with statistics, smooth flat map ↔ globe transitions, and country labels",
   "type": "module",
   "main": "./dist/gralobe.umd.cjs",
@@ -35,22 +35,9 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/batikanor/gralobe"
+    "url": "git+https://github.com/batikanor/gralobe.git"
   },
   "homepage": "https://github.com/batikanor/gralobe#readme",
-  "scripts": {
-    "dev": "vite",
-    "build": "tsc && vite build",
-    "build:lib": "tsc && vite build --mode lib",
-    "preview": "vite preview",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:e2e": "playwright test",
-    "test:ui": "playwright test --ui",
-    "lint": "biome check .",
-    "format": "biome check --write .",
-    "prepublishOnly": "npm run build:lib"
-  },
   "peerDependencies": {
     "three": ">=0.150.0"
   },
@@ -74,5 +61,17 @@
     "three": ">=0.150.0",
     "topojson-client": "^3.1.0",
     "world-atlas": "^2.0.2"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "build:lib": "tsc && vite build --mode lib",
+    "preview": "vite preview",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "playwright test",
+    "test:ui": "playwright test --ui",
+    "lint": "biome check .",
+    "format": "biome check --write ."
   }
-}
+}