@mapcomponents/react-maplibre 0.1.33 → 0.1.36

package/src/components/MapLibreMap/lib/MapLibreGlWrapper.ts

@@ -0,0 +1,636 @@
+import { Map, IControl, MapOptions } from "maplibre-gl";
+
+type EventArgArray = [string, string | Function, Function?];
+type LayerState = {
+  id: string;
+  type: string;
+  visible: boolean;
+  baseLayer: boolean;
+};
+type ViewportState = {
+  center: { lng: number; lat: number };
+  zoom: number;
+  bearing: number;
+  pitch: number;
+};
+
+/**
+ * Creates a MapLibre-gl-js instance and offers all of the native MapLibre functions and properties as well as additional functionality such as element registration & cleanup and more events.
+ *
+ * @param {object} props
+ *
+ * @class
+ */
+class MapLibreGlWrapper {
+  registeredElements: {
+    [key: string]: {
+      layers: [string?];
+      sources: [string?];
+      images: [string?];
+      controls: [IControl?];
+      events: [EventArgArray?];
+      wrapperEvents: [EventArgArray?];
+    };
+  };
+  baseLayers: [string?];
+  firstSymbolLayer: string | undefined;
+  eventHandlers: { layerchange: [Function?]; viewportchange: [Function?] };
+  wrapper: {
+    on: Function;
+    off: Function;
+    fire: Function;
+    layerState: [LayerState?];
+    layerStateString: string;
+    oldLayerStateStrings: object;
+    buildLayerObject: Function;
+    buildLayerObjects: Function;
+    refreshLayerState: Function;
+    viewportState: ViewportState;
+    viewportStateString: string;
+    oldViewportStateString: string;
+    getViewport: Function;
+    refreshViewport: Function;
+  };
+  initRegisteredElements: Function;
+  addNativeMaplibreFunctionsAndProps: Function;
+  map: Map;
+  style: object;
+
+  styleJson: object;
+  addLayer: Function;
+  addSource: Function;
+  addControl: Function;
+  addImage: Function;
+  on: Function;
+  cleanup: Function;
+
+  constructor(props: { mapOptions: MapOptions; onReady: Function }) {
+    // closure variable to safely point to the object context of the current MapLibreGlWrapper instance
+    let self = this;
+
+    // element registration and cleanup on a component level is experimental
+    this.registeredElements = {};
+
+    // array of base layer ids, all layers that have been added by the style passed to the MapLibreGl coonstructor
+    this.baseLayers = [];
+
+    // layer id of the first symbol layer
+    this.firstSymbolLayer = undefined;
+
+    // event handlers registered in MapLibreGlWrapper
+    this.eventHandlers = {
+      layerchange: [],
+      viewportchange: [],
+    };
+
+    // functions and properties provided by the wrapper
+    // Add new functions and properties introduced by the wrapper to this object to prevent collisions due to future MapLibre API changes
+    this.wrapper = {
+      /**
+       * Subscribe the given event handler to an event
+       *
+       * @param {string} eventName
+       * @param {function} handler
+       * @param {object} options
+       * @param {string} componentId
+       * @returns {undefined}
+       */
+      on: (
+        eventName: string,
+        handler: Function,
+        options?: object | string,
+        componentId?: string
+      ) => {
+        if (!self.eventHandlers[eventName]) return;
+
+        if (typeof options === "string") {
+          componentId = options;
+          options = {};
+        }
+
+        self.eventHandlers[eventName].push({ handler, options });
+
+        let _arguments: EventArgArray = [eventName, handler];
+        if (componentId && typeof componentId === "string") {
+          self.initRegisteredElements(componentId);
+          self.registeredElements[componentId].wrapperEvents.push(_arguments);
+        }
+      },
+      /**
+       * Unsubscribes the given event handler from an event
+       *
+       * @param {string} eventName
+       * @param {function} handler
+       * @returns {undefined}
+       */
+      off: (eventName: string, handler: Function) => {
+        if (!self.eventHandlers[eventName]) return;
+
+        self.eventHandlers[eventName] = self.eventHandlers[eventName].filter(
+          (item: any) => {
+            if (!Object.is(item.handler, handler)) {
+              return item;
+            }
+            return false;
+          }
+        );
+      },
+      /**
+       * Calls all event handlers that have been subscribed to the given eventName
+       *
+       * @param {string} eventName
+       * @param {object} context
+       * @returns {undefined}
+       */
+      fire: (eventName: string, context: object) => {
+        if (!self.eventHandlers[eventName]) return;
+
+        var scope = context || window;
+        let event = new Event(eventName);
+
+        self.eventHandlers[eventName].forEach(function (item: any) {
+          item.handler.call(scope, event, self);
+        });
+      },
+      /**
+       * Array containing an object for each layer in the MapLibre instance providing information on visibility, loading state, order, paint & layout properties
+       */
+      layerState: [],
+      /**
+       * Maps layerIds to layerState in JSON string form for quick deep comparisons
+       */
+      layerStateString: "",
+      /**
+       * Previous Version of layerStateString
+       */
+      oldLayerStateStrings: {},
+      /**
+       * Builds the layer info object for a given layer id
+       *
+       * @param {string} layer
+       * @returns object
+       */
+      buildLayerObject: (layer: any) => {
+        //if (self.baseLayers.indexOf(layer.id) === -1) {
+        //let paint = {};
+        //let values = layer.paint?._values;
+        //Object.keys(values || {}).map((propName) => {
+        //  paint[propName] =
+        //    typeof values[propName].value !== "undefined"
+        //      ? values[propName].value.value
+        //      : values[propName];
+        //});
+        //let layout = {};
+        //values = layer.layout?._values;
+        //Object.keys(values || {}).map((propName) => {
+        //  layout[propName] =
+        //    typeof values[propName].value !== "undefined"
+        //      ? values[propName].value.value
+        //      : values[propName];
+        //});
+        return {
+          id: layer.id,
+          type: layer.type,
+          visible: layer.visibility === "none" ? false : true,
+          baseLayer: self.baseLayers.indexOf(layer.id) !== -1,
+          //paint,
+          //layout,
+          //filter: layers[layerId].filter,
+          //layout: layers[layerId].layout,
+          //maxzoom: layers[layerId].maxzoom,
+          //metadata: layers[layerId].metadata,
+          //minzoom: layers[layerId].minzoom,
+          //paint: layers[layerId].paint.get(),
+          //source: layers[layerId].source,
+          //sourceLayer: layers[layerId].sourceLayer,
+        };
+        //}
+      },
+      /**
+       * Returns an array of layer state info objects for all layers in the MapLibre instance
+       *
+       * @returns array
+       */
+      buildLayerObjects: () => {
+        // @ts-ignore
+        return self.style._order
+          .map((layerId: string) => {
+            return self.wrapper.buildLayerObject(
+              self.map.style._layers[layerId]
+            );
+          })
+          .filter((n: string) => n);
+      },
+      /**
+       * Updates layer state info objects
+       */
+      refreshLayerState: () => {
+        self.wrapper.layerState = self.wrapper.buildLayerObjects();
+        if (
+          JSON.stringify(self.wrapper.layerState) !==
+          self.wrapper.layerStateString
+        ) {
+          self.wrapper.fire("layerchange");
+          self.wrapper.layerStateString = JSON.stringify(
+            self.wrapper.layerState
+          );
+        }
+      },
+      /**
+       * Object containing information on the current viewport state
+       */
+      viewportState: {
+        center:{lng:0,lat:0},
+        zoom: 0,
+        bearing:0,
+        pitch:0
+      },
+      /**
+       * The same data as viewportState in JSON string form for quick deep comparisons
+       */
+      viewportStateString: "{}",
+      /**
+       * Previous version of viewportStateString
+       */
+      oldViewportStateString: "{}",
+      getViewport: () =>
+        typeof self.map.getCenter === "function"
+          ? {
+              center: (({ lng, lat }) => ({ lng, lat }))(self.map.getCenter()),
+              zoom: self.map.getZoom(),
+              bearing: self.map.getBearing(),
+              pitch: self.map.getPitch(),
+            }
+          : {},
+      refreshViewport: () => {
+        self.wrapper.viewportState = self.wrapper.getViewport();
+      },
+    };
+
+    /**
+     * Initializes an empty registered elements object for the given componentId
+     *
+     * @param {string} componentId
+     * @param {boolean} force
+     */
+    this.initRegisteredElements = (
+      componentId: string,
+      force: boolean | undefined
+    ) => {
+      if (
+        typeof self.registeredElements[componentId] === "undefined" ||
+        (typeof force !== "undefined" && force)
+      ) {
+        self.registeredElements[componentId] = {
+          layers: [],
+          sources: [],
+          images: [],
+          events: [],
+          controls: [],
+          wrapperEvents: [],
+        };
+      }
+    };
+
+    /**
+     * Overrides MapLibre-gl-js addLayer function providing an additional componentId parameter for the wrapper element registration.
+     *
+     * @param {object} layer
+     * @param {string} beforeId
+     * @param {string} componentId
+     * @returns {undefined}
+     */
+    this.addLayer = (layer: any, beforeId: string, componentId: string) => {
+      if (!self.map.style) {
+        return;
+      }
+      if (
+        componentId &&
+        typeof componentId === "string" &&
+        typeof layer.id !== "undefined"
+      ) {
+        self.initRegisteredElements(componentId);
+        self.registeredElements[componentId].layers.push(layer.id);
+
+        if (typeof layer.source === "object") {
+          self.registeredElements[componentId].sources.push(layer.id);
+        }
+      }
+
+      self.map.addLayer(layer, beforeId);
+    };
+
+    /**
+     * Overrides MapLibre-gl-js addSource function providing an additional componentId parameter for the wrapper element registration.
+     *
+     * @param {string} sourceId
+     * @param {object} source
+     * @param {object} options
+     * @param {string} componentId
+     * @returns {undefined}
+     */
+    this.addSource = (sourceId: string, source: any, componentId: string) => {
+      if (!self.map.style) {
+        return;
+      }
+      if (
+        componentId &&
+        typeof componentId === "string" &&
+        typeof sourceId !== "undefined"
+      ) {
+        self.initRegisteredElements(componentId);
+        self.registeredElements[componentId].sources.push(sourceId);
+      }
+
+      self.map.addSource(sourceId, source);
+    };
+
+    /**
+     * Overrides MapLibre-gl-js addImage function providing an additional componentId parameter for the wrapper element registration.
+     *
+     * @param {string} id
+     * @param {*} image
+     * @param {*} ref
+     * @param {string} componentId
+     * @returns {undefined}
+     */
+    this.addImage = (id: string, image: any, ref: any, componentId: string) => {
+      if (!self.map.style) {
+        return;
+      }
+      if (typeof ref === "string" && typeof componentId === "undefined") {
+        return self.addImage.call(self, id, image, undefined, ref);
+      }
+      if (
+        componentId &&
+        typeof componentId === "string" &&
+        typeof id !== "undefined"
+      ) {
+        self.initRegisteredElements(componentId);
+        self.registeredElements[componentId].images.push(id);
+      }
+
+      self.map.addImage(id, image, ref);
+    };
+
+    /**
+     * Overrides MapLibre-gl-js on function providing an additional componentId parameter for the wrapper element registration.
+     *
+     * @param {string} type
+     * @param {string} layerId
+     * @param {function} handler
+     * @param {string} componentId
+     * @returns {undefined}
+     */
+    this.on = (
+      type: string,
+      layerId: string,
+      handler: Function,
+      componentId: string
+    ) => {
+      if (typeof handler === "string" && typeof layerId === "function") {
+        return self.on.call(self, type, undefined, layerId, handler);
+      }
+
+      let _arguments: EventArgArray = [type, layerId, handler];
+      if (!layerId) {
+        _arguments = [type, handler];
+      }
+
+      if (componentId && typeof componentId === "string") {
+        self.initRegisteredElements(componentId);
+        self.registeredElements[componentId].events.push(_arguments);
+      }
+
+      // @ts-ignore:
+      self.map.on(..._arguments);
+    };
+
+    /**
+     * Overrides MapLibre-gl-js addControl function providing an additional componentId parameter for the wrapper element registration.
+     *
+     * @param {object} control
+     * @param {string} position
+     * @param {string} componentId
+     */
+    this.addControl = (control: any, position: any, componentId: string) => {
+      if (componentId && typeof componentId === "string") {
+        self.initRegisteredElements(componentId);
+        self.registeredElements[componentId].controls.push(control);
+      }
+
+      self.map.addControl(control, position);
+    };
+
+    /**
+     * Removes anything that has been added to the maplibre instance referenced with componentId
+     *
+     * @param {string} componentId
+     */
+    this.cleanup = (componentId: string) => {
+      if (
+        self.map.style &&
+        typeof self.registeredElements[componentId] !== "undefined"
+      ) {
+        // cleanup layers
+        self.registeredElements[componentId].layers.forEach((item: any) => {
+          if (self.map.style.getLayer(item)) {
+            self.map.style.removeLayer(item);
+          }
+        });
+
+        // cleanup sources
+        self.registeredElements[componentId].sources.forEach((item: any) => {
+          if (self.map.style.getSource(item)) {
+            self.map.style.removeSource(item);
+          }
+        });
+
+        // cleanup images
+        self.registeredElements[componentId].images.forEach((item: any) => {
+          if (self.map.hasImage(item)) {
+            self.map.style.removeImage(item);
+          }
+        });
+
+        // cleanup events
+        self.registeredElements[componentId].events.forEach((item: any) => {
+          // @ts-ignore
+          self.map.off(...item);
+        });
+
+        // cleanup controls
+        self.registeredElements[componentId].controls.forEach((item: any) => {
+          self.map.removeControl(item);
+        });
+
+        // cleanup wrapper events
+        self.registeredElements[componentId].wrapperEvents.forEach(
+          (item: any) => {
+            self.wrapper.off(...item);
+          }
+        );
+
+        self.initRegisteredElements(componentId, true);
+      }
+    };
+
+    // add style prop functions that require map._update to be called afterwards
+    let updatingStyleFunctions = [
+      "moveLayer",
+      "removeLayer",
+      "removeSource",
+      "setPaintProperty",
+      "setLayoutProperty",
+    ];
+    updatingStyleFunctions.forEach((item) => {
+      this[item] = (...props: any[]) => {
+        if (
+          self.map &&
+          this.map.style &&
+          typeof self.map.style[item] === "function"
+        ) {
+          self.map.style[item](...props);
+        }
+        return self.map._update ? self.map._update(true) : undefined;
+      };
+    });
+
+    // add style prop functions
+    let styleFunctions = [
+      "getLayer",
+      "getSource",
+      "listImages",
+      "getPaintProperty",
+      "getLayoutProperty",
+      "removeImage",
+    ];
+    styleFunctions.forEach((item) => {
+      this[item] = (...props: any[]) => {
+        if (self.map && self.map.style) {
+          return self.map.style[item](...props);
+        }
+        return false;
+      };
+    });
+
+    this.addNativeMaplibreFunctionsAndProps = () => {
+      //  add MapLibre-gl functions
+      Object.getOwnPropertyNames(Object.getPrototypeOf(this.map)).forEach(
+        (item) => {
+          if (typeof this[item] === "undefined") {
+            this[item] = (...props: any[]) => self.map[item](...props);
+          }
+        }
+      );
+
+      //  add MapLibre-gl properties
+      Object.keys(this.map).forEach((item) => {
+        if (typeof this[item] === "undefined") {
+          this[item] = self.map[item];
+        }
+      });
+    };
+
+    // add functions that are missing on the MapLibre instances prototype
+    let missingFunctions = [
+      "getZoom",
+      "setZoom",
+      "getCenter",
+      "setCenter",
+      "getBearing",
+      "setBearing",
+      "getPitch",
+      "setPitch",
+      "jumpTo",
+      "flyTo",
+      "panTo",
+      "panBy",
+      "panBy",
+      "zoomTo",
+      "zoomIn",
+      "zoomOut",
+      "getPadding",
+      "setPadding",
+      "rotateTo",
+      "resetNorth",
+      "resetNorthPitch",
+      "snapToNorth",
+      "cameraForBounds",
+      "fitBounds",
+      "fitScreenCoordinates",
+      "getFreeCameraOptions",
+      "setFreeCameraOptions",
+      "easeTo",
+      "stop",
+    ];
+    missingFunctions.forEach((item) => {
+      this[item] = (...props: any[]) => {
+        if (typeof self.map[item] === "function") {
+          return self.map[item].call(self.map, ...props);
+        }
+        return undefined;
+      };
+    });
+
+    // initialize the MapLibre-gl instance
+    let initializeMapLibre = async () => {
+      // if mapOptions style URL is given and if it is not a mapbox URL fetch the json and initialize the mapbox object
+      if (
+        typeof props.mapOptions.style === "string" &&
+        props.mapOptions.style.indexOf("mapbox://") === -1
+      ) {
+        await fetch(props.mapOptions.style)
+          .then((response) => {
+            if (response.ok) {
+              return response.json();
+            } else {
+              throw new Error("error loading map style.json");
+            }
+          })
+          .then((styleJson) => {
+            styleJson.layers.forEach((item: any) => {
+              self.baseLayers.push(item.id);
+              if (!self.firstSymbolLayer && item.type === "symbol") {
+                self.firstSymbolLayer = item.id;
+              }
+            });
+            self.styleJson = styleJson;
+            props.mapOptions.style = styleJson;
+          })
+          .catch((error) => {
+            console.log(error);
+          });
+      }
+
+      self.map = new Map(props.mapOptions);
+
+      self.addNativeMaplibreFunctionsAndProps();
+      self.wrapper.refreshViewport();
+      self.wrapper.fire("viewportchange");
+
+      self.map.on("load", () => {
+        self.addNativeMaplibreFunctionsAndProps();
+      });
+
+      self.map.on("move", () => {
+        self.wrapper.viewportState = self.wrapper.getViewport();
+        self.wrapper.fire("viewportchange");
+      });
+      self.map.on("idle", () => {
+        self.wrapper.refreshLayerState();
+      });
+      self.map.on("data", () => {
+        self.wrapper.refreshLayerState();
+      });
+      if (typeof props.onReady === "function") {
+        props.onReady(self.map, self);
+      }
+    };
+    initializeMapLibre();
+  }
+}
+
+export default MapLibreGlWrapper;
+
+export type { LayerState, ViewportState };

package/src/components/MlComponentTemplate/MlComponentTemplate.stories.js

@@ -8,8 +8,6 @@ const storyoptions = {
   title: "MapComponents/MlComponentTemplate",
   component: MlComponentTemplate,
   argTypes: {
-    url: {},
-    layer: {},
   },
   decorators: mapContextDecorator,
 };

package/src/components/MlComponentTemplate/MlComponentTemplate.tsx

@@ -0,0 +1,42 @@
+import React, { useRef, useEffect } from "react";
+import useMap from "../../hooks/useMap";
+
+interface MlComponentTemplateProps {
+  /**
+   * Id of the target MapLibre instance in mapContext
+   */
+  mapId?: string;
+  /**
+   * Id of an existing layer in the mapLibre instance to help specify the layer order
+   * This layer will be visually beneath the layer with the "insertBeforeLayer" id.
+   */
+  insertBeforeLayer?: string;
+}
+
+/**
+ * Component template
+ *
+ */
+const MlComponentTemplate = (props: MlComponentTemplateProps) => {
+  const mapHook = useMap({
+    mapId: props.mapId,
+    waitForLayer: props.insertBeforeLayer,
+  });
+  const initializedRef = useRef(false);
+
+  useEffect(() => {
+    if (!mapHook.map || initializedRef.current) return;
+    // the MapLibre-gl instance (mapHook.map) is accessible here
+    // initialize the layer and add it to the MapLibre-gl instance or do something else with it
+    initializedRef.current = true;
+
+    mapHook.map.map.setCenter([7.132122000552613, 50.716405378037706]);
+  }, [mapHook.map, props.mapId]);
+
+  return <></>;
+};
+
+MlComponentTemplate.defaultProps = {
+  mapId: undefined,
+};
+export default MlComponentTemplate;

package/src/components/MlCreatePdfButton/MlCreatePdfButton.stories.js

@@ -10,11 +10,6 @@ const storyoptions = {
   title: "MapComponents/MlCreatePdfButton",
   component: MlCreatePdfButton,
   argTypes: {
-    options: {
-      control: {
-        type: "object",
-      },
-    },
   },
   decorators: mapContextDecorator,
 };