@geoql/v-maplibre 1.3.0 → 1.5.0

package/README.md

@@ -17,35 +17,40 @@
 - 🚀 **Nuxt 4 Ready** - Seamlessly works with Nuxt 4 and SSR
 - 🎯 **PMTiles Built-in** - Native support for PMTiles protocol
 - 🌐 **deck.gl Integration** - High-performance WebGL visualization layers
+- 🛰️ **COG/GeoTIFF Support** - GPU-accelerated Cloud-Optimized GeoTIFF layers
+- 📡 **LiDAR Viewer** - LAS/LAZ/COPC point cloud visualization with streaming
 
 ## Installation
 
 ```bash
 # bun
-bun add @geoql/v-maplibre maplibre-gl
+bun add @geoql/v-maplibre maplibre-gl @deck.gl/{core,layers,mapbox,aggregation-layers,geo-layers,mesh-layers} maplibre-gl-wind
 
 # npm
-npm install @geoql/v-maplibre maplibre-gl
+npm install @geoql/v-maplibre maplibre-gl @deck.gl/{core,layers,mapbox,aggregation-layers,geo-layers,mesh-layers} maplibre-gl-wind
 
 # yarn
-yarn add @geoql/v-maplibre maplibre-gl
+yarn add @geoql/v-maplibre maplibre-gl @deck.gl/{core,layers,mapbox,aggregation-layers,geo-layers,mesh-layers} maplibre-gl-wind
 
 # pnpm
-pnpm add @geoql/v-maplibre maplibre-gl
+pnpm add @geoql/v-maplibre maplibre-gl @deck.gl/{core,layers,mapbox,aggregation-layers,geo-layers,mesh-layers} maplibre-gl-wind
 ```
 
-### deck.gl Layers (Optional)
+> **Note:** All packages listed above are required peer dependencies. Without them, your build will fail with missing export errors.
 
-For deck.gl visualization layers, install the required packages:
+### Additional Optional Dependencies
+
+Install these packages based on the features you need:
 
 ```bash
-# Core deck.gl packages
-bun add @deck.gl/core @deck.gl/layers @deck.gl/mapbox
+# Raster/COG layers (Cloud-Optimized GeoTIFF)
+bun add @developmentseed/deck.gl-raster geotiff-geokeys-to-proj4
+
+# LiDAR viewer control
+bun add maplibre-gl-lidar
 
-# Additional layer packages (as needed)
-bun add @deck.gl/aggregation-layers  # Heatmap, Hexagon, Grid
-bun add @deck.gl/geo-layers          # Trips, MVT, Tile, H3
-bun add @deck.gl/mesh-layers         # SimpleMesh, Scenegraph
+# Wind particle visualization
+bun add maplibre-gl-wind
 ```
 
 ## Quick Start
@@ -88,6 +93,7 @@ bun add @deck.gl/mesh-layers         # SimpleMesh, Scenegraph
 - **`VLayerMaplibreCanvas`** - Canvas layers
 - **`VLayerMaplibreCluster`** - Clustered point layers
 - **`VLayerMaplibrePmtile`** - PMTiles layers
+- **`VLayerMaplibreRoute`** - Route/delivery tracking visualization
 
 ### deck.gl Layer Components
 
@@ -122,13 +128,39 @@ High-performance WebGL visualization layers powered by deck.gl:
 - `VLayerDeckglTile3D` - 3D Tiles (Cesium)
 - `VLayerDeckglTerrain` - Terrain mesh
 - `VLayerDeckglH3Hexagon` - H3 hexagons
+- `VLayerDeckglH3Cluster` - Clustered H3 hexagon regions
 - `VLayerDeckglGreatCircle` - Great circle arcs
+- `VLayerDeckglWMS` - Web Map Service tiles
+
+**Tile System Layers**
+
+- `VLayerDeckglS2` - Google S2 geometry cells
+- `VLayerDeckglGeohash` - Geohash spatial indexing
+- `VLayerDeckglQuadkey` - Bing Maps Quadkey tiles
+- `VLayerDeckglGridCell` - Pre-aggregated grid cells
 
 **Mesh Layers**
 
 - `VLayerDeckglSimpleMesh` - 3D meshes
 - `VLayerDeckglScenegraph` - glTF/GLB models
 
+**Point Cloud Layers**
+
+- `VLayerDeckglPointCloud` - LiDAR/photogrammetry point clouds
+- `VLayerDeckglSolidPolygon` - 3D extruded solid polygons
+
+**Raster Layers** (requires `@developmentseed/deck.gl-raster`)
+
+- `VLayerDeckglCOG` - Cloud-Optimized GeoTIFF visualization (GPU-accelerated, auto-reprojection)
+
+**Wind Visualization** (requires `maplibre-gl-wind`)
+
+- `VLayerDeckglWindParticle` - Animated wind particle flow with speed-based color ramps
+
+**Generic Layer**
+
+- `VLayerDeckgl` - Use any deck.gl layer class directly
+
 ### Control Components
 
 - **`VControlNavigation`** - Navigation controls (zoom, rotate)
@@ -136,6 +168,7 @@ High-performance WebGL visualization layers powered by deck.gl:
 - **`VControlGeolocate`** - Geolocation control
 - **`VControlFullscreen`** - Fullscreen toggle
 - **`VControlAttribution`** - Attribution control
+- **`VControlLidar`** - LiDAR point cloud viewer (LAS/LAZ/COPC support, streaming, color schemes)
 
 ## deck.gl Example
 
@@ -171,6 +204,44 @@ High-performance WebGL visualization layers powered by deck.gl:
 </template>
 ```
 
+## Wind Visualization Example
+
+```vue
+<script setup lang="ts">
+  import { VMap, VLayerDeckglWindParticle } from '@geoql/v-maplibre';
+
+  const mapOptions = {
+    style: 'https://basemaps.cartocdn.com/gl/dark-matter-gl-style/style.json',
+    center: [0, 20],
+    zoom: 2,
+  };
+
+  // Wind data points with speed (m/s) and direction (degrees, 0=North)
+  const windData = [
+    { lat: 40.7, lon: -74.0, speed: 5.2, direction: 180 },
+    { lat: 34.0, lon: -118.2, speed: 3.1, direction: 270 },
+    // ... more points
+  ];
+</script>
+
+<template>
+  <VMap :options="mapOptions" style="height: 500px">
+    <VLayerDeckglWindParticle
+      id="wind"
+      :wind-data="windData"
+      :num-particles="8192"
+      :speed-factor="50"
+      :color-ramp="[
+        [0.0, [59, 130, 189, 255]],
+        [0.5, [253, 174, 97, 255]],
+        [1.0, [213, 62, 79, 255]],
+      ]"
+      :speed-range="[0, 30]"
+    ></VLayerDeckglWindParticle>
+  </VMap>
+</template>
+```
+
 ## Usage with Nuxt
 
 For Nuxt applications, wrap the map component with `ClientOnly`:

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import { VControlAttribution, VControlFullscreen, VControlGeolocate, VControlNavigation, VControlScale, VControlLidar } from './controls';
-import { VLayerMaplibreCanvas, VLayerMaplibreGeojson, VLayerMaplibreCluster, VLayerMaplibreImage, VLayerMaplibreRaster, VLayerMaplibreVector, VLayerMaplibreVideo, VLayerMaplibrePmtile } from './layers';
+import { VLayerMaplibreCanvas, VLayerMaplibreGeojson, VLayerMaplibreCluster, VLayerMaplibreImage, VLayerMaplibreRaster, VLayerMaplibreVector, VLayerMaplibreVideo, VLayerMaplibrePmtile, VLayerMaplibreRoute } from './layers';
 import VMap from './map/VMap.vue';
 import VMarker from './markers/VMarker.vue';
 import VPopup from './popups/VPopup.vue';
-export { VMap, VMarker, VPopup, VLayerMaplibreCanvas, VLayerMaplibreGeojson, VLayerMaplibreCluster, VLayerMaplibreImage, VLayerMaplibreRaster, VLayerMaplibreVector, VLayerMaplibreVideo, VLayerMaplibrePmtile, VControlAttribution, VControlFullscreen, VControlGeolocate, VControlNavigation, VControlScale, VControlLidar, };
+export { VMap, VMarker, VPopup, VLayerMaplibreCanvas, VLayerMaplibreGeojson, VLayerMaplibreCluster, VLayerMaplibreImage, VLayerMaplibreRaster, VLayerMaplibreVector, VLayerMaplibreVideo, VLayerMaplibrePmtile, VLayerMaplibreRoute, VControlAttribution, VControlFullscreen, VControlGeolocate, VControlNavigation, VControlScale, VControlLidar, };
 export type { LidarControlOptions, ColorScheme, CopcLoadingMode, PointCloudInfo, PointCloudBounds, StreamingProgress, } from './controls';
 export * from './layers/deckgl';
 export default VMap;