@yarrow-uz/yarrow-map-web-sdk 1.0.40 → 1.0.41

package/README.md

@@ -355,10 +355,45 @@ yarrowMap.addLayer(
   featureCollection, // GeoJSON FeatureCollection
   paint,            // Paint properties object
   layout,           // Layout properties object
-  iconSettings      // Icon configuration (width, height)
+  iconSettings,     // Icon configuration (width, height)
+  options           // Optional: { sourceId?: string, filter?: LayerFilter }
 );
 ```
 
+### Managing Sources Explicitly
+
+```javascript
+yarrowMap.addSource('vehicles-source', vehicleFeatureCollection);
+yarrowMap.updateSourceData('vehicles-source', nextVehicleFeatureCollection);
+
+yarrowMap.addLayer(
+  'active-vehicles',
+  'circle',
+  nextVehicleFeatureCollection,
+  {
+    'circle-radius': ['interpolate', ['linear'], ['zoom'], 10, 4, 16, 10],
+    'circle-color': ['case', ['==', ['get', 'status'], 'active'], '#16a34a', '#9ca3af']
+  },
+  {},
+  {},
+  {
+    sourceId: 'vehicles-source',
+    filter: ['==', ['get', 'status'], 'active']
+  }
+);
+```
+
+### Feature State and Rendered Queries
+
+```javascript
+yarrowMap.setFeatureState(
+  { source: 'vehicles-source', id: 101 },
+  { selected: true }
+);
+
+const features = yarrowMap.queryRenderedFeatures({ layers: ['active-vehicles'] });
+```
+
 **Symbol layer with custom icons:**
 
 ```javascript
@@ -916,7 +951,11 @@ constructor(
 | `onIconClick(layerGroup, callback)` | `layerGroup: 'pois' \| 'buildings', callback: Function` | `void` | Listen for icon clicks |
 | `onLayerClick(layerGroup, callback)` | `layerGroup: 'pois' \| 'buildings', callback: Function` | `void` | Alias for onIconClick (same method) |
 | `changeBackgroundColor(color)` | `color: string` | `void` | Change map background color |
-| `addLayer()` | `layerName, layerType, featureCollection, paint?, layout?, iconSettings?` | `void` | Add a layer to the map |
+| `addSource()` | `sourceId, data` | `void` | Add/replace a GeoJSON source |
+| `updateSourceData()` | `sourceId, data` | `void` | Update data for an existing GeoJSON source (or create it) |
+| `addLayer()` | `layerName, layerType, featureCollection, paint?, layout?, iconSettings?, options?` | `void` | Add a layer to the map (supports `sourceId` and `filter`) |
+| `setFeatureState()` | `featureIdentifier, state` | `void` | Set state for a specific feature |
+| `queryRenderedFeatures()` | `geometryOrOptions?, options?` | `MapGeoJSONFeature[]` | Query currently rendered features (supports `{ layers }`) |
 | `removeLayer(layerName)` | `layerName: string` | `void` | Remove a layer from the map |
 | `addMarker(coordinates, options?)` | `coordinates: [lat, lng], options?: MarkerOptions` | `Marker \| null` | Add a marker to the map |
 | `removeMarker(marker)` | `marker: Marker` | `void` | Remove a marker from the map |
@@ -967,9 +1006,10 @@ interface SearchOptions {
 
 ## Version Information
 
-- **Current Version**: 1.0.39
+- **Current Version**: 1.0.41
 - **Dependencies**: maplibre-gl ^5.5.0, axios ^1.7.9
 - **Repository**: https://git.yarrow.uz/yarrow-sdk/frontend/yarrow-map-web-sdk
+- **Changelog**: `CHANGELOG.md`
 
 ## Support