mobility-toolbox-js 3.0.0-beta.9 → 3.0.0

package/ol/layers/MaplibreStyleLayer.d.ts

@@ -1,155 +1,73 @@
+import { FeatureState } from 'maplibre-gl';
 import { Feature, Map } from 'ol';
 import { Coordinate } from 'ol/coordinate';
-import { ObjectEvent } from 'ol/Object';
+import { EventsKey } from 'ol/events';
 import { Layer } from 'ol/layer';
-import { Source } from 'ol/source';
-import { LayerGetFeatureInfoResponse } from '../../types';
+import { ObjectEvent } from 'ol/Object';
 import { FilterFunction } from '../../common/typedefs';
-import MaplibreLayer, { MaplibreLayerOptions } from './MaplibreLayer';
+import { LayerGetFeatureInfoResponse } from '../../types';
 import MaplibreStyleLayerRenderer from '../renderers/MaplibreStyleLayerRenderer';
-export type MaplibreStyleLayerOptions = MaplibreLayerOptions & {
+import MaplibreLayer, { MaplibreLayerOptions } from './MaplibreLayer';
+export type MaplibreStyleLayerOptions = {
     beforeId?: string;
-    maplibreLayer?: MaplibreLayer;
     layers?: maplibregl.AddLayerObject[];
     layersFilter?: FilterFunction;
+    maplibreLayer?: MaplibreLayer;
     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").default | import("ol/View").ViewStateLayerStateExtent | undefined) => boolean;
-        getAttributions: (view?: import("ol/View").default | 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;
+} & MaplibreLayerOptions;
 /**
- * Layer for visualizing a specific set of layer from a MapboxLayer.
+ * Layer that helps show/hide a specific subset of style layers of a [MaplibreLayer](./MaplibreLayer.js~MaplibreLayer.html).
  *
  * @example
- * import { MapboxLayer, MapboxStyleLayer } from 'mobility-toolbox-js/ol';
+ * import { MaplibreLayer, MaplibreStyleLayer } from 'mobility-toolbox-js/ol';
  *
- * const maplibreLayer = new MapboxLayer({
- *   url: 'https://maps.geops.io/styles/travic_v2/style.json?key=[yourApiKey]',
+ * const maplibreLayer = new MaplibreLayer({
+ *   apiKey: 'yourApiKey',
  * });
  *
- * const layer = new MapboxStyleLayer({
+ * const layer = new MaplibreStyleLayer({
  *   maplibreLayer: maplibreLayer,
- *   styleLayersFilter: () => {},
+ *   layersFilter: (layer) => {
+ *     // show/hide only style layers related to stations
+ *     return /station/.test(layer.id);
+ *   },
  * });
  *
- * @classproperty {ol/Map~Map} map - The map where the layer is displayed.
+ * @see <a href="/example/ol-maplibre-style-layer">OpenLayers MaplibreStyle layer example</a>
  * @extends {ol/layer/Layer~Layer}
+ * @public
  */
-declare class MaplibreStyleLayer extends MaplibreStyleLayer_base {
+declare class MaplibreStyleLayer extends Layer {
     highlightedFeatures: Feature[];
+    olEventsKeys: EventsKey[];
     selectedFeatures: Feature[];
     get beforeId(): string;
-    set beforeId(newValue: string[]);
+    set beforeId(newValue: string | undefined);
     get layers(): maplibregl.AddLayerObject[];
     set layers(newValue: maplibregl.AddLayerObject[]);
     get layersFilter(): (layer: maplibregl.LayerSpecification) => boolean;
     set layersFilter(newValue: (layer: maplibregl.LayerSpecification) => boolean);
+    /**
+     * @deprecated Use MaplibreStyleLayer.maplibreLayer instead.
+     */
     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;
-    });
+    get sources(): Record<string, maplibregl.SourceSpecification>;
+    set sources(newValue: Record<string, maplibregl.SourceSpecification>);
     /**
-     * @deprecated
+     * @deprecated Use MaplibreStyleLayer.layer instead.
      */
     get styleLayer(): maplibregl.AddLayerObject;
     /**
      * @deprecated
      */
     set styleLayer(newValue: maplibregl.AddLayerObject);
+    /**
+     * Apply visibility to style layers that fits the styleLayersFilter function.
+     */
     /**
      * @deprecated
      */
@@ -162,74 +80,78 @@ declare class MaplibreStyleLayer extends MaplibreStyleLayer_base {
      * 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 {string} [options.beforeId] The style layer id to use when the options.layers property is defined, unsused otherwise.
      * @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 {MaplibreLayer} [options.maplibreLayer] The MaplibreLayer to use.
      * @param {FilterFunction} [options.queryRenderedLayersFilter] Filter function to decide which style layer are available for query.
+     * @param {{[id: string]:maplibregl.SourceSpecification}} [options.sources] The sources to add to the style on load.
+     * @public
      */
-    constructor(options: MaplibreStyleLayerOptions);
-    createRenderer(): MaplibreStyleLayerRenderer;
+    constructor(options?: MaplibreStyleLayerOptions);
+    addLayers(): void;
+    addSources(): void;
+    applyLayoutVisibility(evt?: ObjectEvent): void;
     /**
      * Initialize the layer.
      * @param {ol/Map~Map} map the Maplibre map.
      * @override
      */
     attachToMap(map: Map): void;
+    /**
+     * Create a copy of the MaplibreStyleLayer.
+     *
+     * @param {Object} newOptions Options to override. See constructor.
+     * @return {MapboxStyleLayer} A MaplibreStyleLayer.
+     * @public
+     */
+    clone(newOptions: MaplibreStyleLayerOptions): MaplibreStyleLayer;
+    createRenderer(): MaplibreStyleLayerRenderer;
     /**
      * 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;
     /**
      * 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.
+     * @deprecated Use getFeatureInfoAtCoordinate([layer], coordinate) from mobility-toolbox-ol package instead.
      */
     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
+     * Highlight a list of features.
+     * @param {Array<ol/Feature~Feature>} [features=[]] Features to highlight.
+     * @deprecated Use layer.setFeatureState(features, {hover: true|false}) instead.
      */
-    setHoverState(features: Feature[], state: boolean): void;
+    highlight(features?: Feature[]): void;
+    /**
+     * On Maplibre map load callback function. Add style layers and dynaimc filters.
+     */
+    onLoad(): void;
+    removeLayers(): void;
+    removeSources(): void;
     /**
      * Select a list of features.
      * @param {Array<ol/Feature~Feature>} [features=[]] Features to select.
-     * @private
+     * @deprecated Use layer.setFeatureState(features, {selected: true|false}) instead.
      */
     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.
+     * Set the [feature state](https://maplibre.org/maplibre-style-spec/expressions/#feature-state) of the features.
      *
-     * @private
+     * @param {ol/Feature~Feature[]} features
+     * @param {{[key: string]: any}} state The feature state
+     * @public
      */
-    applyLayoutVisibility(evt?: ObjectEvent): void;
+    setFeatureState(features: Feature[], state: FeatureState): void;
     /**
-     * Create a copy of the MapboxStyleLayer.
-     * @param {Object} newOptions Options to override.
-     * @return {MapboxStyleLayer} A MapboxStyleLayer.
+     * Set if features are hovered or not.
+     * @param {Array<ol/Feature~Feature>} features
+     * @param {boolean} state Is the feature hovered
+     * @deprecated Use layer.setFeatureState(features, {hover: true|false}) instead.
      */
-    clone(newOptions: MaplibreStyleLayerOptions): MaplibreStyleLayer;
+    setHoverState(features: Feature[], state: boolean): void;
+    setMapInternal(map: Map): void;
 }
 export default MaplibreStyleLayer;