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

package/README.md

@@ -140,7 +140,7 @@ const mapConfig = new YarrowMapConfig({
   theme,        // 'light' | 'dark' (default: 'light')
   cache,        // { enabled?: boolean, lifespanDays?: number }
   brandBadgePosition, // 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right'
-  controls      // { enabled?: boolean, position?: 'left'|'right', zoom?: boolean, compass?: boolean }
+  controls      // { enabled?: boolean, position?: 'left'|'left-top'|'left-bottom'|'right'|'right-top'|'right-bottom', zoom?: boolean, compass?: boolean }
 });
 ```
 
@@ -163,7 +163,7 @@ const mapConfig = new YarrowMapConfig({
   brandBadgePosition: 'top-right',
   controls: {
     enabled: true,         // Yarrow controls are OFF by default
-    position: 'right',     // Optional side of the map
+    position: 'right-bottom', // Optional placement: left/left-top/left-bottom/right/right-top/right-bottom
     zoom: true,            // Optional
     compass: true          // Optional
   },
@@ -175,6 +175,8 @@ yarrowMap.init().then(() => {
 });
 ```
 
+When controls and the brand badge are placed in the same corner (for example `right-bottom` with `brandBadgePosition: 'bottom-right'`), the SDK automatically adds spacing so they do not overlap.
+
 ## Basic Map Manipulation
 
 ### Changing the Map Style
@@ -355,8 +357,43 @@ 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:**
@@ -893,7 +930,13 @@ constructor(
     brandBadgePosition?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
     controls?: {
       enabled?: boolean;      // default: false
-      position?: 'left' | 'right';
+      position?:
+        | 'left'
+        | 'left-top'
+        | 'left-bottom'
+        | 'right'
+        | 'right-top'
+        | 'right-bottom';
       zoom?: boolean;         // default: true
       compass?: boolean;      // default: true
     };
@@ -916,7 +959,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 +1014,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