mobility-toolbox-js 3.0.0-beta.1 → 3.0.0-beta.11

package/ol/layers/MaplibreLayer.js

@@ -1,8 +1,13 @@
+import Source from 'ol/source/Source';
+import BaseEvent from 'ol/events/Event';
+import Layer from 'ol/layer/Layer';
+import debounce from 'lodash.debounce';
 import { Map } from 'maplibre-gl';
-import MapGlLayer from './MapGlLayer';
+import { getUrlWithParams, getMapGlCopyrights } from '../../common/utils';
+import MobilityLayerMixin from '../mixins/MobilityLayerMixin';
 import MaplibreLayerRenderer from '../renderers/MaplibreLayerRenderer';
 /**
- * This layer is meant to facilitate the use of the geOps Maps api in an OpenLayers map using Maplibre.
+ * An OpenLayers layer able to display data from the [geOps Maps API](https://developer.geops.io/apis/maps).
  *
  * @example
  * import { MaplibreLayer } from 'mobility-toolbox-js/ol';
@@ -28,10 +33,40 @@ import MaplibreLayerRenderer from '../renderers/MaplibreLayerRenderer';
  * @extends {ol/layer/Layer~Layer}
  * @public
  */
-export default class MaplibreLayer extends MapGlLayer {
-    /** @private */
-    get maplibreMap() {
-        return this.mbMap;
+class MaplibreLayer extends MobilityLayerMixin(Layer) {
+    get apiKey() {
+        return this.get('apiKey');
+    }
+    set apiKey(newValue) {
+        this.set('apiKey', newValue);
+    }
+    get apiKeyName() {
+        return this.get('apiKeyName');
+    }
+    set apiKeyName(newValue) {
+        this.set('apiKeyName', newValue);
+    }
+    get mbMap() {
+        console.warn('Deprecated. Use layer.maplibreMap.');
+        return this.maplibreMap;
+    }
+    get queryRenderedFeaturesOptions() {
+        return this.get('queryRenderedFeaturesOptions');
+    }
+    set queryRenderedFeaturesOptions(newValue) {
+        this.set('queryRenderedFeaturesOptions', newValue);
+    }
+    get style() {
+        return this.get('style');
+    }
+    set style(newValue) {
+        this.set('style', newValue);
+    }
+    get url() {
+        return this.get('url');
+    }
+    set url(newValue) {
+        this.set('url', newValue);
     }
     /**
      * Constructor.
@@ -44,21 +79,108 @@ export default class MaplibreLayer extends MapGlLayer {
      * @param {string} [options.url="https://maps.geops.io"] The geOps Maps api url.
      */
     constructor(options) {
-        super(Object.assign({}, options));
+        super(Object.assign(Object.assign({ source: new Source({
+                attributions: () => {
+                    return ((this.maplibreMap && getMapGlCopyrights(this.maplibreMap)) || []);
+                },
+            }), apiKeyName: 'key', style: 'travic_v2', url: 'https://maps.geops.io' }, (options || {})), { 
+            // @ts-expect-error mapOptions must be saved by the mixin in this.options
+            mapOptions: Object.assign({ interactive: false, trackResize: false, attributionControl: false }, ((options === null || options === void 0 ? void 0 : options.mapOptions) || {})), queryRenderedFeaturesOptions: Object.assign({}, ((options === null || options === void 0 ? void 0 : options.queryRenderedFeaturesOptions) || {})) }));
     }
     /**
-     * @private
+     * Initialize the layer and listen to feature clicks.
+     * @param {ol/Map~Map} map
      */
-    createRenderer() {
-        return new MaplibreLayerRenderer(this);
+    attachToMap(map) {
+        super.attachToMap(map);
+        this.loadMbMap();
+        const updateMaplibreMapDebounced = debounce(this.updateMaplibreMap.bind(this), 150);
+        this.olListenersKeys.push(this.on('propertychange', (evt) => {
+            if (/(apiKey|apiKeyName|url|style)/.test(evt.key)) {
+                updateMaplibreMapDebounced();
+            }
+        }));
+    }
+    /**
+     * Terminate what was initialized in init function. Remove layer, events...
+     */
+    detachFromMap() {
+        if (this.maplibreMap) {
+            // Some asynchrone repaints are triggered even if the mbMap has been removed,
+            // to avoid display of errors we set an empty function.
+            this.maplibreMap.triggerRepaint = () => { };
+            this.maplibreMap.remove();
+            this.maplibreMap = undefined;
+        }
+        this.loaded = false;
+        super.detachFromMap();
     }
     /**
+     * Create the Maplibre map.
      * @private
      */
+    loadMbMap() {
+        var _a, _b, _c;
+        this.loaded = false;
+        this.olListenersKeys.push(
+        // @ts-ignore
+        (_a = this.map) === null || _a === void 0 ? void 0 : _a.on('change:target', this.loadMbMap.bind(this)));
+        if (!((_b = this.map) === null || _b === void 0 ? void 0 : _b.getTargetElement())) {
+            return;
+        }
+        if (!this.visible) {
+            // On next change of visibility we load the map
+            this.olListenersKeys.push(
+            // @ts-ignore
+            this.once('change:visible', this.loadMbMap.bind(this)));
+            return;
+        }
+        const container = document.createElement('div');
+        container.style.position = 'absolute';
+        container.style.width = '100%';
+        container.style.height = '100%';
+        /**
+         * A Maplibre map
+         * @type {maplibregl.Map}
+         */
+        this.maplibreMap = this.createMap(Object.assign({ style: this.getStyle(), container }, (((_c = this.options) === null || _c === void 0 ? void 0 : _c.mapOptions) || {})));
+        this.maplibreMap.on('sourcedata', () => {
+            var _a;
+            (_a = this.getSource()) === null || _a === void 0 ? void 0 : _a.refresh(); // Refresh attribution
+        });
+        this.maplibreMap.once('load', () => {
+            this.loaded = true;
+            this.dispatchEvent(new BaseEvent('load'));
+        });
+    }
+    getStyle() {
+        // If the style is a complete style object, use it directly.
+        if (this.style &&
+            typeof this.style === 'object' &&
+            this.style.name &&
+            this.style.version) {
+            return this.style;
+        }
+        // If the url set is already a complete style url, use it directly.
+        if (this.url.includes('style.json')) {
+            return this.url;
+        }
+        /// Otherwise build the complete style url.
+        return getUrlWithParams(`${this.url}/styles/${this.style}/style.json`, {
+            [this.apiKeyName]: this.apiKey,
+        }).toString();
+    }
     // eslint-disable-next-line class-methods-use-this
     createMap(options) {
         return new Map(options);
     }
+    createRenderer() {
+        return new MaplibreLayerRenderer(this);
+    }
+    updateMaplibreMap() {
+        var _a;
+        (_a = this.maplibreMap) === null || _a === void 0 ? void 0 : _a.setStyle(this.getStyle(), { diff: false });
+    }
     /**
      * Create a copy of the MaplibreLayer.
      * @param {MaplibreLayerOptions} newOptions Options to override
@@ -68,3 +190,4 @@ export default class MaplibreLayer extends MapGlLayer {
         return new MaplibreLayer(Object.assign(Object.assign({}, (this.options || {})), (newOptions || {})));
     }
 }
+export default MaplibreLayer;

package/ol/layers/MaplibreStyleLayer.d.ts

@@ -0,0 +1,241 @@
+import { Feature, Map } from 'ol';
+import { Coordinate } from 'ol/coordinate';
+import { ObjectEvent } from 'ol/Object';
+import { Layer } from 'ol/layer';
+import { FeatureState } from 'maplibre-gl';
+import { Source } from 'ol/source';
+import { LayerGetFeatureInfoResponse } from '../../types';
+import { FilterFunction } from '../../common/typedefs';
+import MaplibreLayer, { MaplibreLayerOptions } from './MaplibreLayer';
+import MaplibreStyleLayerRenderer from '../renderers/MaplibreStyleLayerRenderer';
+export type MaplibreStyleLayerOptions = MaplibreLayerOptions & {
+    beforeId?: string;
+    maplibreLayer?: MaplibreLayer;
+    layers?: maplibregl.AddLayerObject[];
+    layersFilter?: FilterFunction;
+    queryRenderedLayersFilter?: FilterFunction;
+};
+declare const MaplibreStyleLayer_base: {
+    new (...args: any[]): {
+        options?: import("../mixins/PropertiesLayerMixin").PropertiesLayerMixinOptions | undefined;
+        olListenersKeys: import("ol/events").EventsKey[];
+        children: Layer<Source, import("ol/renderer/Layer").default<any>>[];
+        get copyrights(): string;
+        set copyrights(newCopyrights: string | string[]);
+        disabled: boolean;
+        readonly group: string;
+        readonly hitTolerance: boolean;
+        readonly key: string;
+        readonly map: Map;
+        readonly name: string;
+        olLayer: Layer<Source, import("ol/renderer/Layer").default<any>>;
+        parent: Layer<Source, import("ol/renderer/Layer").default<any>>;
+        visible: boolean;
+        setMapInternal: ((map: Map) => void) & ((map: Map | null) => void);
+        onChildrenChange(oldValue: Layer<Source, import("ol/renderer/Layer").default<any>>[]): void;
+        attachToMap(map: Map): void;
+        detachFromMap(): void;
+        flat(): any[];
+        addEventListener: (type: string, listener: import("ol/events").Listener) => void;
+        removeEventListener: (type: string, listener: import("ol/events").Listener) => void;
+        on: import("ol/layer/Layer").LayerOnSignature<import("ol/events").EventsKey>;
+        render: (frameState: import("ol/Map").FrameState | null, target: HTMLElement) => HTMLElement | null;
+        once: import("ol/layer/Layer").LayerOnSignature<import("ol/events").EventsKey>;
+        un: import("ol/layer/Layer").LayerOnSignature<void>;
+        getSource: () => Source | null;
+        getRenderSource: () => Source | null;
+        getFeatures: (pixel: import("ol/pixel").Pixel) => Promise<import("ol/Feature").FeatureLike[]>;
+        getData: (pixel: import("ol/pixel").Pixel) => Float32Array | Uint8ClampedArray | Uint8Array | DataView | null;
+        isVisible: (view?: import("ol").View | import("ol/View").ViewStateLayerStateExtent | undefined) => boolean;
+        getAttributions: (view?: import("ol").View | import("ol/View").ViewStateLayerStateExtent | undefined) => string[];
+        unrender: () => void;
+        getDeclutter: () => string;
+        renderDeclutter: (frameState: import("ol/Map").FrameState, layerState: import("ol/layer/Layer").State) => void;
+        renderDeferred: (frameState: import("ol/Map").FrameState) => void;
+        getMapInternal: () => Map | null;
+        setMap: (map: Map | null) => void;
+        setSource: (source: Source | null) => void;
+        getRenderer: () => import("ol/renderer/Layer").default<any> | null;
+        hasRenderer: () => boolean;
+        getBackground: () => false | import("ol/layer/Base").BackgroundColor;
+        getClassName: () => string;
+        getLayerState: (managed?: boolean | undefined) => import("ol/layer/Layer").State;
+        getLayersArray: (array?: Layer<Source, import("ol/renderer/Layer").default<any>>[] | undefined) => Layer<Source, import("ol/renderer/Layer").default<any>>[];
+        getLayerStatesArray: (states?: import("ol/layer/Layer").State[] | undefined) => import("ol/layer/Layer").State[];
+        getExtent: () => import("ol/extent").Extent | undefined;
+        getMaxResolution: () => number;
+        getMinResolution: () => number;
+        getMinZoom: () => number;
+        getMaxZoom: () => number;
+        getOpacity: () => number;
+        getSourceState: () => import("ol/source/Source").State;
+        getVisible: () => boolean;
+        getZIndex: () => number | undefined;
+        setBackground: (background?: import("ol/layer/Base").BackgroundColor | undefined) => void;
+        setExtent: (extent: import("ol/extent").Extent | undefined) => void;
+        setMaxResolution: (maxResolution: number) => void;
+        setMinResolution: (minResolution: number) => void;
+        setMaxZoom: (maxZoom: number) => void;
+        setMinZoom: (minZoom: number) => void;
+        setOpacity: (opacity: number) => void;
+        setVisible: (visible: boolean) => void;
+        setZIndex: (zindex: number) => void;
+        get: (key: string) => any;
+        getKeys: () => string[];
+        getProperties: () => {
+            [x: string]: any;
+        };
+        getPropertiesInternal: () => {
+            [x: string]: any;
+        } | null;
+        hasProperties: () => boolean;
+        notify: (key: string, oldValue: any) => void;
+        addChangeListener: (key: string, listener: import("ol/events").Listener) => void;
+        removeChangeListener: (key: string, listener: import("ol/events").Listener) => void;
+        set: (key: string, value: any, silent?: boolean | undefined) => void;
+        setProperties: (values: {
+            [x: string]: any;
+        }, silent?: boolean | undefined) => void;
+        unset: (key: string, silent?: boolean | undefined) => void;
+        changed: () => void;
+        getRevision: () => number;
+        dispatchEvent: (event: string | import("ol/events/Event").default) => boolean | undefined;
+        getListeners: (type: string) => import("ol/events").Listener[] | undefined;
+        hasListener: (type?: string | undefined) => boolean;
+        dispose: () => void;
+    };
+} & typeof Layer;
+/**
+ * Layer for visualizing a specific set of layer from a MapboxLayer.
+ *
+ * @example
+ * import { MapboxLayer, MapboxStyleLayer } from 'mobility-toolbox-js/ol';
+ *
+ * const maplibreLayer = new MapboxLayer({
+ *   url: 'https://maps.geops.io/styles/travic_v2/style.json?key=[yourApiKey]',
+ * });
+ *
+ * const layer = new MapboxStyleLayer({
+ *   maplibreLayer: maplibreLayer,
+ *   styleLayersFilter: () => {},
+ * });
+ *
+ * @classproperty {ol/Map~Map} map - The map where the layer is displayed.
+ * @extends {ol/layer/Layer~Layer}
+ */
+declare class MaplibreStyleLayer extends MaplibreStyleLayer_base {
+    highlightedFeatures: Feature[];
+    selectedFeatures: Feature[];
+    get beforeId(): string;
+    set beforeId(newValue: string[]);
+    get layers(): maplibregl.AddLayerObject[];
+    set layers(newValue: maplibregl.AddLayerObject[]);
+    get layersFilter(): (layer: maplibregl.LayerSpecification) => boolean;
+    set layersFilter(newValue: (layer: maplibregl.LayerSpecification) => boolean);
+    get mapboxLayer(): MaplibreLayer | undefined;
+    get maplibreLayer(): MaplibreLayer;
+    set maplibreLayer(newValue: MaplibreLayer);
+    get queryRenderedLayersFilter(): (layer: maplibregl.LayerSpecification) => boolean;
+    set queryRenderedLayersFilter(newValue: (layer: maplibregl.LayerSpecification) => boolean);
+    get sources(): {
+        [key: string]: maplibregl.SourceSpecification;
+    };
+    set sources(newValue: {
+        [key: string]: maplibregl.SourceSpecification;
+    });
+    /**
+     * @deprecated
+     */
+    get styleLayer(): maplibregl.AddLayerObject;
+    /**
+     * @deprecated
+     */
+    set styleLayer(newValue: maplibregl.AddLayerObject);
+    /**
+     * @deprecated
+     */
+    get styleLayers(): maplibregl.AddLayerObject[];
+    /**
+     * @deprecated
+     */
+    set styleLayers(newValue: maplibregl.AddLayerObject[]);
+    /**
+     * Constructor.
+     *
+     * @param {Object} options
+     * @param {MapboxLayer} [options.maplibreLayer] The MaplibreLayer to use.
+     * @param {maplibregl.SourceSpecification[]} [options.sources] The source to add to the style on load.
+     * @param {maplibregl.AddLayerObject[]} [options.layers] The layers to add to the style on load.
+     * @param {FilterFunction} [options.layersFilter] Filter function to decide which style layer to apply visiblity on. If not provided, the 'layers' property is used.
+     * @param {FilterFunction} [options.queryRenderedLayersFilter] Filter function to decide which style layer are available for query.
+     */
+    constructor(options: MaplibreStyleLayerOptions);
+    createRenderer(): MaplibreStyleLayerRenderer;
+    /**
+     * Initialize the layer.
+     * @param {ol/Map~Map} map the Maplibre map.
+     * @override
+     */
+    attachToMap(map: Map): void;
+    /**
+     * Terminate the layer.
+     * @override
+     */
+    detachFromMap(): void;
+    /** @private */
+    addSources(): void;
+    /** @private */
+    removeSources(): void;
+    /** @private */
+    addLayers(): void;
+    /** @private */
+    removeLayers(): void;
+    /**
+     * On Maplibre map load callback function. Add style layers and dynaimc filters.
+     * @private
+     */
+    onLoad(): void;
+    /**
+     * Set the feature state of the features.
+     * @param {Array<ol/Feature~Feature>} features
+     * @param {{[key:string]:boolean}} state The feature state
+     * @public
+     */
+    setFeatureState(features: Feature[], state: FeatureState): void;
+    /**
+     * Request feature information for a given coordinate.
+     * @param {ol/coordinate~Coordinate} coordinate Coordinate to request the information at.
+     * @return {Promise<FeatureInfo>} Promise with features, layer and coordinate.
+     */
+    getFeatureInfoAtCoordinate(coordinate: Coordinate): Promise<LayerGetFeatureInfoResponse>;
+    /**
+     * Set if features are hovered or not.
+     * @param {Array<ol/Feature~Feature>} features
+     * @param {boolean} state Is the feature hovered
+     * @private
+     */
+    setHoverState(features: Feature[], state: boolean): void;
+    /**
+     * Select a list of features.
+     * @param {Array<ol/Feature~Feature>} [features=[]] Features to select.
+     * @private
+     */
+    select(features?: Feature[]): void;
+    /**
+     * Highlight a list of features.
+     * @param {Array<ol/Feature~Feature>} [features=[]] Features to highlight.
+     * @private
+     */
+    highlight(features?: Feature[]): void;
+    /**
+     * Apply visibility to style layers that fits the styleLayersFilter function.
+     */
+    applyLayoutVisibility(evt?: ObjectEvent): void;
+    /**
+     * Create a copy of the MapboxStyleLayer.
+     * @param {Object} newOptions Options to override.
+     * @return {MapboxStyleLayer} A MapboxStyleLayer.
+     */
+    clone(newOptions: MaplibreStyleLayerOptions): MaplibreStyleLayer;
+}
+export default MaplibreStyleLayer;

package/ol/layers/MaplibreStyleLayer.js

@@ -135,35 +135,37 @@ class MaplibreStyleLayer extends MobilityLayerMixin(Layer) {
         if (!this.map || !this.maplibreLayer) {
             return;
         }
-        // Apply the initial visibiltity.
-        const { maplibreMap } = this.maplibreLayer;
-        if (!maplibreMap) {
-            // If the maplibreMap is not yet created because the  map has no target yet, we
+        if (!this.map.getTargetElement()) {
+            // If ther e is no target element the maplibreMap is not yet created, we
             // relaunch the initialisation when it's the case.
             this.olListenersKeys.push(this.map.on('change:target', () => {
                 this.attachToMap(map);
             }));
             return;
         }
-        // maplibreMap.loaded() and maplibreMap.isStyleLoaded() are reliable only on the first call of init.
-        // On the next call (when a topic change for example), these functions returns false because
-        // the style is being modified.
-        // That's why we rely on a property instead for the next calls.
-        if (maplibreMap.loaded()) {
-            this.onLoad();
-        }
-        else {
-            maplibreMap.once('load', this.onLoad);
+        // Apply the initial visibility if possible otherwise we wait for the load event of the layer
+        const { maplibreMap } = this.maplibreLayer;
+        if (maplibreMap) {
+            // maplibreMap.loaded() and maplibreMap.isStyleLoaded() are reliable only on the first call of init.
+            // On the next call (when a topic change for example), these functions returns false because
+            // the style is being modified.
+            // That's why we rely on a property instead for the next calls.
+            if (maplibreMap.loaded()) {
+                this.onLoad();
+            }
+            else {
+                maplibreMap.once('load', this.onLoad);
+            }
         }
         // Apply the visibiltity when layer's visibility change.
-        this.olListenersKeys.push(this.on('change:visible', (evt) => {
+        this.olListenersKeys.push(
+        // @ts-expect-error 'load' is a custom event
+        this.maplibreLayer.on('load', this.onLoad.bind(this)), this.on('change:visible', (evt) => {
             // Once the map is loaded we can apply visiblity without waiting
             // the style. Maplibre take care of the application of style changes.
             this.applyLayoutVisibility(evt);
-        }), 
-        // @ts-expect-error 'load' is a custom event form mobility-toolbox-js
-        this.maplibreLayer.on('load', this.onLoad), this.on('propertychange', (evt) => {
-            if (/(sources|layers|layersFilter|maplibreLayer|beforeId|)/.test(evt.key)) {
+        }), this.on('propertychange', (evt) => {
+            if (/(sources|layers|layersFilter|maplibreLayer|beforeId)/.test(evt.key)) {
                 this.detachFromMap();
                 this.attachToMap(map);
             }
@@ -185,13 +187,12 @@ class MaplibreStyleLayer extends MobilityLayerMixin(Layer) {
     /** @private */
     addSources() {
         var _a;
-        if (!((_a = this.maplibreLayer) === null || _a === void 0 ? void 0 : _a.maplibreMap) || !Array.isArray(this.sources)) {
+        if (!((_a = this.maplibreLayer) === null || _a === void 0 ? void 0 : _a.maplibreMap) || !this.sources) {
             return;
         }
         const { maplibreMap } = this.maplibreLayer;
         if (maplibreMap) {
-            this.sources.forEach((source) => {
-                const { id } = source;
+            Object.entries(this.sources).forEach(([id, source]) => {
                 if (!maplibreMap.getSource(id)) {
                     maplibreMap.addSource(id, source);
                 }
@@ -201,13 +202,12 @@ class MaplibreStyleLayer extends MobilityLayerMixin(Layer) {
     /** @private */
     removeSources() {
         var _a;
-        if (!((_a = this.maplibreLayer) === null || _a === void 0 ? void 0 : _a.maplibreMap) || !Array.isArray(this.layers)) {
+        if (!((_a = this.maplibreLayer) === null || _a === void 0 ? void 0 : _a.maplibreMap) || !this.sources) {
             return;
         }
         const { maplibreMap } = this.maplibreLayer;
         if (maplibreMap) {
-            this.sources.forEach((source) => {
-                const { id } = source;
+            Object.keys(this.sources).forEach((id) => {
                 if (maplibreMap.getSource(id)) {
                     maplibreMap.removeSource(id);
                 }
@@ -268,6 +268,34 @@ class MaplibreStyleLayer extends MobilityLayerMixin(Layer) {
             this.disabled = !styles.length;
         }
     }
+    /**
+     * Set the feature state of the features.
+     * @param {Array<ol/Feature~Feature>} features
+     * @param {{[key:string]:boolean}} state The feature state
+     * @public
+     */
+    setFeatureState(features, state) {
+        var _a;
+        if (!((_a = this.maplibreLayer) === null || _a === void 0 ? void 0 : _a.maplibreMap) || !features.length) {
+            return;
+        }
+        const { maplibreMap } = this.maplibreLayer;
+        features.forEach((feature) => {
+            const { source, sourceLayer } = feature.get(VECTOR_TILE_FEATURE_PROPERTY) || {};
+            if ((!source && !sourceLayer) || !feature.getId()) {
+                if (!feature.getId()) {
+                    // eslint-disable-next-line no-console
+                    console.warn("No feature's id found. To use the feature state functionnality, tiles must be generated with --generate-ids. See https://github.com/Maplibre/tippecanoe#adding-calculated-attributes.", feature.getId(), feature.getProperties());
+                }
+                return;
+            }
+            maplibreMap.setFeatureState({
+                id: feature.getId(),
+                source,
+                sourceLayer,
+            }, state);
+        });
+    }
     /**
      * Request feature information for a given coordinate.
      * @param {ol/coordinate~Coordinate} coordinate Coordinate to request the information at.
@@ -275,6 +303,8 @@ class MaplibreStyleLayer extends MobilityLayerMixin(Layer) {
      */
     getFeatureInfoAtCoordinate(coordinate) {
         var _a;
+        // eslint-disable-next-line no-console
+        console.warn(`Deprecated. getFeatureInfoAtCoordinate([layer], coordinate) from ol package instead.`);
         if (!((_a = this.maplibreLayer) === null || _a === void 0 ? void 0 : _a.maplibreMap)) {
             return Promise.resolve({ coordinate, features: [], layer: this });
         }
@@ -342,26 +372,9 @@ class MaplibreStyleLayer extends MobilityLayerMixin(Layer) {
      * @private
      */
     setHoverState(features, state) {
-        var _a;
-        if (!((_a = this.maplibreLayer) === null || _a === void 0 ? void 0 : _a.maplibreMap) || !features.length) {
-            return;
-        }
-        const { maplibreMap } = this.maplibreLayer;
-        features.forEach((feature) => {
-            const { source, sourceLayer } = feature.get(VECTOR_TILE_FEATURE_PROPERTY) || {};
-            if ((!source && !sourceLayer) || !feature.getId()) {
-                if (!feature.getId()) {
-                    // eslint-disable-next-line no-console
-                    console.warn("No feature's id found. To use the feature state functionnality, tiles must be generated with --generate-ids. See https://github.com/Maplibre/tippecanoe#adding-calculated-attributes.", feature.getId(), feature.getProperties());
-                }
-                return;
-            }
-            maplibreMap.setFeatureState({
-                id: feature.getId(),
-                source,
-                sourceLayer,
-            }, { hover: state });
-        });
+        // eslint-disable-next-line no-console
+        console.warn(`Deprecated. Use layer.setFeatureState(features, {hover: ${state}}) instead.`);
+        this.setFeatureState(features, { hover: state });
     }
     /**
      * Select a list of features.
@@ -369,6 +382,8 @@ class MaplibreStyleLayer extends MobilityLayerMixin(Layer) {
      * @private
      */
     select(features = []) {
+        // eslint-disable-next-line no-console
+        console.warn(`Deprecated. Use layer.setFeatureState(features, {selected: true}) instead.`);
         this.setHoverState(this.selectedFeatures || [], false);
         this.selectedFeatures = features;
         this.setHoverState(this.selectedFeatures || [], true);
@@ -380,6 +395,8 @@ class MaplibreStyleLayer extends MobilityLayerMixin(Layer) {
      */
     highlight(features = []) {
         var _a;
+        // eslint-disable-next-line no-console
+        console.warn(`Deprecated. Use layer.setFeatureState(features, {highlighted: true}) instead.`);
         // Filter out selected features
         const filtered = ((_a = this.highlightedFeatures) === null || _a === void 0 ? void 0 : _a.filter((feature) => !(this.selectedFeatures || [])
             .map((feat) => feat.getId())
@@ -392,8 +409,6 @@ class MaplibreStyleLayer extends MobilityLayerMixin(Layer) {
     }
     /**
      * Apply visibility to style layers that fits the styleLayersFilter function.
-     *
-     * @private
      */
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     applyLayoutVisibility(evt) {