@record-evolution/widget-mapbox 1.5.16 → 1.5.18

package/package.json

@@ -3,7 +3,7 @@
     "description": "REWidget widget-mapbox",
     "license": "MIT",
     "author": "widget-mapbox",
-    "version": "1.5.16",
+    "version": "1.5.18",
     "engines": {
         "node": ">=24.9.0",
         "npm": ">=10.0.2"
@@ -31,7 +31,7 @@
     "dependencies": {
         "@types/geojson": "^7946.0.16",
         "@types/mapbox-gl": "^3.5.0",
-        "lit": "^3.3.1",
+        "lit": "^3.3.3",
         "mapbox-gl": "^3.23.1",
         "tinycolor2": "^1.6.0"
     },

package/src/definition-schema.d.ts

@@ -143,7 +143,7 @@ export type Dataseries = {
 /**
  * A Mapbox-powered geospatial visualization widget for displaying location-based data on interactive maps. Use this widget for GPS tracking, asset locations, geographic heatmaps, route visualization, or any data with latitude/longitude coordinates. Supports multiple layer types including circles (points), symbols (icons), heatmaps (density), and lines (tracks/routes). Features auto-follow mode to keep markers in view, multiple map styles, and pivot-based auto-generation of layers from data columns. Ideal for fleet management, IoT device monitoring, field service tracking, and geographic data analysis.
  */
-export interface InputData {
+export interface MapConfiguration {
   title?: Title;
   subTitle?: Subtitle;
   style?: MapStyle;

package/src/definition-schema.json

@@ -1,6 +1,21 @@
 {
-    "title": "InputData",
+    "title": "Map Configuration",
     "description": "A Mapbox-powered geospatial visualization widget for displaying location-based data on interactive maps. Use this widget for GPS tracking, asset locations, geographic heatmaps, route visualization, or any data with latitude/longitude coordinates. Supports multiple layer types including circles (points), symbols (icons), heatmaps (density), and lines (tracks/routes). Features auto-follow mode to keep markers in view, multiple map styles, and pivot-based auto-generation of layers from data columns. Ideal for fleet management, IoT device monitoring, field service tracking, and geographic data analysis.",
+    "aiSelection": {
+        "dataShape": "Points carrying coordinates: dataseries[].data[] entries with lon and lat, optionally alt and a numeric value, rendered as circles, icons, a density heatmap or connected lines. A pivot column produces one layer per distinct value.",
+        "useWhen": [
+            "Position on the earth is the point — vehicle and asset locations, site maps, field service, GPS traces.",
+            "A route or track should be drawn by connecting points in order (dataseries[].type: 'line').",
+            "Density across an area should be shaded (dataseries[].type: 'heatmap').",
+            "The view should keep following the latest position (follow: true)."
+        ],
+        "notFor": [
+            "Coordinates that are only incidental, where the real question is a measured value over time — use widget-linechart.",
+            "Positions on a floor plan, schematic or photo rather than on the earth — use widget-overlay.",
+            "Distance, speed or dwell time presented as numbers — use widget-value or widget-table.",
+            "How long an asset stayed in each place or state — use widget-statehistory."
+        ]
+    },
     "type": "object",
     "properties": {
         "title": {

package/src/widget-mapbox.ts

@@ -9,13 +9,13 @@ import tinycolor from 'tinycolor2'
 import {
     CircleLayerConfiguration,
     HeatmapLayerConfiguration,
-    InputData,
+    MapConfiguration,
     MapData,
     SymbolLayerConfiguration,
     TrackLayerConfiguration
 } from './definition-schema.js'
 
-type Dataseries = Exclude<InputData['dataseries'], undefined>[number]
+type Dataseries = Exclude<MapConfiguration['dataseries'], undefined>[number]
 type Point = Exclude<Dataseries['data'], undefined>[number]
 type Theme = {
     theme_name: string
@@ -37,7 +37,7 @@ type DataSet = {
 
 @customElement('widget-mapbox-versionplaceholder')
 export class WidgetMapbox extends LitElement {
-    @property({ type: Object }) inputData?: InputData
+    @property({ type: Object }) inputData?: MapConfiguration
     @property({ type: Object }) theme?: Theme
 
     @state() private map: any | undefined = undefined
@@ -62,7 +62,7 @@ export class WidgetMapbox extends LitElement {
             this.updateMap()
         })
         mapboxgl.accessToken =
-            'pk.eyJ1IjoibWFya29wZSIsImEiOiJjazc1OWlsNjkwN2pyM2VxajV1eGRnYzgwIn0.3lVksk1nej_0KnWjCkBDAA'
+            'pk.eyJ1IjoibWFya29wZSIsImEiOiJjbXB2Yjh2ankwMWUxMnNyM243aGFlNGxiIn0.BXax9rCajgo3Sn5MvAu7dQ'
     }
 
     disconnectedCallback() {