ps-toolkit-ui 0.0.207 → 0.0.211

package/src/assets/plugins/highcharts/code/es-modules/Extensions/GeoJSON.js

@@ -0,0 +1,436 @@
+/* *
+ *
+ *  (c) 2010-2021 Torstein Honsi
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+'use strict';
+import Chart from '../Core/Chart/Chart.js';
+import F from '../Core/FormatUtilities.js';
+var format = F.format;
+import H from '../Core/Globals.js';
+var win = H.win;
+import U from '../Core/Utilities.js';
+var error = U.error, extend = U.extend, merge = U.merge, wrap = U.wrap;
+/**
+ * Represents the loose structure of a geographic JSON file.
+ *
+ * @interface Highcharts.GeoJSON
+ */ /**
+* Full copyright note of the geographic data.
+* @name Highcharts.GeoJSON#copyright
+* @type {string|undefined}
+*/ /**
+* Short copyright note of the geographic data suitable for watermarks.
+* @name Highcharts.GeoJSON#copyrightShort
+* @type {string|undefined}
+*/ /**
+* Additional meta information based on the coordinate reference system.
+* @name Highcharts.GeoJSON#crs
+* @type {Highcharts.Dictionary<any>|undefined}
+*/ /**
+* Data sets of geographic features.
+* @name Highcharts.GeoJSON#features
+* @type {Array<Highcharts.GeoJSONFeature>}
+*/ /**
+* Map projections and transformations to be used when calculating between
+* lat/lon and chart values. Required for lat/lon support on maps. Allows
+* resizing, rotating, and moving portions of a map within its projected
+* coordinate system while still retaining lat/lon support. If using lat/lon
+* on a portion of the map that does not match a `hitZone`, the definition with
+* the key `default` is used.
+* @name Highcharts.GeoJSON#hc-transform
+* @type {Highcharts.Dictionary<Highcharts.GeoJSONTranslation>|undefined}
+*/ /**
+* Title of the geographic data.
+* @name Highcharts.GeoJSON#title
+* @type {string|undefined}
+*/ /**
+* Type of the geographic data. Type of an optimized map collection is
+* `FeatureCollection`.
+* @name Highcharts.GeoJSON#type
+* @type {string|undefined}
+*/ /**
+* Version of the geographic data.
+* @name Highcharts.GeoJSON#version
+* @type {string|undefined}
+*/
+/**
+ * Data set of a geographic feature.
+ * @interface Highcharts.GeoJSONFeature
+ * @extends Highcharts.Dictionary<*>
+ */ /**
+* Data type of the geographic feature.
+* @name Highcharts.GeoJSONFeature#type
+* @type {string}
+*/
+/**
+ * Describes the map projection and transformations applied to a portion of
+ * a map.
+ * @interface Highcharts.GeoJSONTranslation
+ */ /**
+* The coordinate reference system used to generate this portion of the map.
+* @name Highcharts.GeoJSONTranslation#crs
+* @type {string}
+*/ /**
+* Define the portion of the map that this defintion applies to. Defined as a
+* GeoJSON polygon feature object, with `type` and `coordinates` properties.
+* @name Highcharts.GeoJSONTranslation#hitZone
+* @type {Highcharts.Dictionary<*>|undefined}
+*/ /**
+* Property for internal use for maps generated by Highsoft.
+* @name Highcharts.GeoJSONTranslation#jsonmarginX
+* @type {number|undefined}
+*/ /**
+* Property for internal use for maps generated by Highsoft.
+* @name Highcharts.GeoJSONTranslation#jsonmarginY
+* @type {number|undefined}
+*/ /**
+* Property for internal use for maps generated by Highsoft.
+* @name Highcharts.GeoJSONTranslation#jsonres
+* @type {number|undefined}
+*/ /**
+* Specifies clockwise rotation of the coordinates after the projection, but
+* before scaling and panning. Defined in radians, relative to the coordinate
+* system origin.
+* @name Highcharts.GeoJSONTranslation#rotation
+* @type {number|undefined}
+*/ /**
+* The scaling factor applied to the projected coordinates.
+* @name Highcharts.GeoJSONTranslation#scale
+* @type {number|undefined}
+*/ /**
+* Property for internal use for maps generated by Highsoft.
+* @name Highcharts.GeoJSONTranslation#xoffset
+* @type {number|undefined}
+*/ /**
+* X offset of projected coordinates after scaling.
+* @name Highcharts.GeoJSONTranslation#xpan
+* @type {number|undefined}
+*/ /**
+* Property for internal use for maps generated by Highsoft.
+* @name Highcharts.GeoJSONTranslation#yoffset
+* @type {number|undefined}
+*/ /**
+* Y offset of projected coordinates after scaling.
+* @name Highcharts.GeoJSONTranslation#ypan
+* @type {number|undefined}
+*/
+/**
+ * Result object of a map transformation.
+ *
+ * @interface Highcharts.MapCoordinateObject
+ */ /**
+* X coordinate on the map.
+* @name Highcharts.MapCoordinateObject#x
+* @type {number}
+*/ /**
+* Y coordinate on the map.
+* @name Highcharts.MapCoordinateObject#y
+* @type {number|null}
+*/
+/**
+ * A latitude/longitude object.
+ *
+ * @interface Highcharts.MapLatLonObject
+ */ /**
+* The latitude.
+* @name Highcharts.MapLatLonObject#lat
+* @type {number}
+*/ /**
+* The longitude.
+* @name Highcharts.MapLatLonObject#lon
+* @type {number}
+*/
+/**
+ * An array of longitude, latitude.
+ *
+ * @typedef {Array<number>} Highcharts.LonLatArray
+ */
+''; // detach doclets above
+/* eslint-disable no-invalid-this, valid-jsdoc */
+/**
+ * Test for point in polygon. Polygon defined as array of [x,y] points.
+ * @private
+ */
+function pointInPolygon(point, polygon) {
+    var i, j, rel1, rel2, c = false, x = point.x, y = point.y;
+    for (i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {
+        rel1 = polygon[i][1] > y;
+        rel2 = polygon[j][1] > y;
+        if (rel1 !== rel2 &&
+            (x < (polygon[j][0] -
+                polygon[i][0]) * (y - polygon[i][1]) /
+                (polygon[j][1] - polygon[i][1]) +
+                polygon[i][0])) {
+            c = !c;
+        }
+    }
+    return c;
+}
+/**
+ * Highmaps only. Get point from latitude and longitude using specified
+ * transform definition.
+ *
+ * @requires modules/map
+ *
+ * @sample maps/series/latlon-transform/
+ *         Use specific transformation for lat/lon
+ *
+ * @function Highcharts.Chart#transformFromLatLon
+ *
+ * @param {Highcharts.MapLatLonObject} latLon
+ *        A latitude/longitude object.
+ *
+ * @param {*} transform
+ *        The transform definition to use as explained in the
+ *        {@link https://www.highcharts.com/docs/maps/latlon|documentation}.
+ *
+ * @return {Highcharts.MapCoordinateObject}
+ *         An object with `x` and `y` properties.
+ */
+Chart.prototype.transformFromLatLon = function (latLon, transform) {
+    /**
+     * Allows to manually load the proj4 library from Highcharts options
+     * instead of the `window`.
+     * In case of loading the library from a `script` tag,
+     * this option is not needed, it will be loaded from there by default.
+     *
+     * @type      {Function}
+     * @product   highmaps
+     * @apioption chart.proj4
+     */
+    var proj4 = this.options.chart.proj4 || win.proj4;
+    if (!proj4) {
+        error(21, false, this);
+        return {
+            x: 0,
+            y: null
+        };
+    }
+    var _a = transform.jsonmarginX, jsonmarginX = _a === void 0 ? 0 : _a, _b = transform.jsonmarginY, jsonmarginY = _b === void 0 ? 0 : _b, _c = transform.jsonres, jsonres = _c === void 0 ? 1 : _c, _d = transform.scale, scale = _d === void 0 ? 1 : _d, _e = transform.xoffset, xoffset = _e === void 0 ? 0 : _e, _f = transform.xpan, xpan = _f === void 0 ? 0 : _f, _g = transform.yoffset, yoffset = _g === void 0 ? 0 : _g, _h = transform.ypan, ypan = _h === void 0 ? 0 : _h;
+    var projected = proj4(transform.crs, [latLon.lon, latLon.lat]), cosAngle = transform.cosAngle ||
+        (transform.rotation && Math.cos(transform.rotation)), sinAngle = transform.sinAngle ||
+        (transform.rotation && Math.sin(transform.rotation)), rotated = transform.rotation ? [
+        projected[0] * cosAngle + projected[1] * sinAngle,
+        -projected[0] * sinAngle + projected[1] * cosAngle
+    ] : projected;
+    return {
+        x: ((rotated[0] - xoffset) * scale + xpan) * jsonres + jsonmarginX,
+        y: -(((yoffset - rotated[1]) * scale + ypan) * jsonres - jsonmarginY)
+    };
+};
+/**
+ * Highmaps only. Get latLon from point using specified transform definition.
+ * The method returns an object with the numeric properties `lat` and `lon`.
+ *
+ * @requires modules/map
+ *
+ * @sample maps/series/latlon-transform/
+ *         Use specific transformation for lat/lon
+ *
+ * @function Highcharts.Chart#transformToLatLon
+ *
+ * @param {Highcharts.Point|Highcharts.MapCoordinateObject} point
+ *        A `Point` instance, or any object containing the properties `x` and
+ *        `y` with numeric values.
+ *
+ * @param {*} transform
+ *        The transform definition to use as explained in the
+ *        {@link https://www.highcharts.com/docs/maps/latlon|documentation}.
+ *
+ * @return {Highcharts.MapLatLonObject|undefined}
+ *         An object with `lat` and `lon` properties.
+ */
+Chart.prototype.transformToLatLon = function (point, transform) {
+    var proj4 = this.options.chart.proj4 || win.proj4;
+    if (!proj4) {
+        error(21, false, this);
+        return;
+    }
+    if (point.y === null) {
+        return;
+    }
+    var _a = transform.jsonmarginX, jsonmarginX = _a === void 0 ? 0 : _a, _b = transform.jsonmarginY, jsonmarginY = _b === void 0 ? 0 : _b, _c = transform.jsonres, jsonres = _c === void 0 ? 1 : _c, _d = transform.scale, scale = _d === void 0 ? 1 : _d, _e = transform.xoffset, xoffset = _e === void 0 ? 0 : _e, _f = transform.xpan, xpan = _f === void 0 ? 0 : _f, _g = transform.yoffset, yoffset = _g === void 0 ? 0 : _g, _h = transform.ypan, ypan = _h === void 0 ? 0 : _h;
+    var normalized = {
+        x: ((point.x - jsonmarginX) / jsonres - xpan) / scale + xoffset,
+        y: ((point.y - jsonmarginY) / jsonres + ypan) / scale + yoffset
+    }, cosAngle = transform.cosAngle ||
+        (transform.rotation && Math.cos(transform.rotation)), sinAngle = transform.sinAngle ||
+        (transform.rotation && Math.sin(transform.rotation)), 
+    // Note: Inverted sinAngle to reverse rotation direction
+    projected = win.proj4(transform.crs, 'WGS84', transform.rotation ? {
+        x: normalized.x * cosAngle + normalized.y * -sinAngle,
+        y: normalized.x * sinAngle + normalized.y * cosAngle
+    } : normalized);
+    return { lat: projected.y, lon: projected.x };
+};
+/**
+ * Highmaps only. Calculate latitude/longitude values for a point. Returns an
+ * object with the numeric properties `lat` and `lon`.
+ *
+ * @requires modules/map
+ *
+ * @sample maps/demo/latlon-advanced/
+ *         Advanced lat/lon demo
+ *
+ * @function Highcharts.Chart#fromPointToLatLon
+ *
+ * @param {Highcharts.Point|Highcharts.MapCoordinateObject} point
+ *        A `Point` instance or anything containing `x` and `y` properties with
+ *        numeric values.
+ *
+ * @return {Highcharts.MapLatLonObject|undefined}
+ *         An object with `lat` and `lon` properties.
+ */
+Chart.prototype.fromPointToLatLon = function (point) {
+    var transforms = this.mapTransforms;
+    if (!transforms) {
+        error(22, false, this);
+        return;
+    }
+    for (var transform in transforms) {
+        if (Object.hasOwnProperty.call(transforms, transform) &&
+            transforms[transform].hitZone &&
+            pointInPolygon(point, transforms[transform].hitZone.coordinates[0])) {
+            return this.transformToLatLon(point, transforms[transform]);
+        }
+    }
+    return this.transformToLatLon(point, transforms['default'] // eslint-disable-line dot-notation
+    );
+};
+/**
+ * Highmaps only. Get chart coordinates from latitude/longitude. Returns an
+ * object with x and y values corresponding to the `xAxis` and `yAxis`.
+ *
+ * @requires modules/map
+ *
+ * @sample maps/series/latlon-to-point/
+ *         Find a point from lat/lon
+ *
+ * @function Highcharts.Chart#fromLatLonToPoint
+ *
+ * @param {Highcharts.MapLatLonObject} latLon
+ *        Coordinates.
+ *
+ * @return {Highcharts.MapCoordinateObject}
+ *         X and Y coordinates in terms of chart axis values.
+ */
+Chart.prototype.fromLatLonToPoint = function (latLon) {
+    var transforms = this.mapTransforms, transform, coords;
+    if (!transforms) {
+        error(22, false, this);
+        return {
+            x: 0,
+            y: null
+        };
+    }
+    for (transform in transforms) {
+        if (Object.hasOwnProperty.call(transforms, transform) &&
+            transforms[transform].hitZone) {
+            coords = this.transformFromLatLon(latLon, transforms[transform]);
+            if (pointInPolygon(coords, transforms[transform].hitZone.coordinates[0])) {
+                return coords;
+            }
+        }
+    }
+    return this.transformFromLatLon(latLon, transforms['default'] // eslint-disable-line dot-notation
+    );
+};
+/**
+ * Highmaps only. Restructure a GeoJSON object in preparation to be read
+ * directly by the
+ * {@link https://api.highcharts.com/highmaps/plotOptions.series.mapData|series.mapData}
+ * option. The GeoJSON will be broken down to fit a specific Highcharts type,
+ * either `map`, `mapline` or `mappoint`. Meta data in GeoJSON's properties
+ * object will be copied directly over to {@link Point.properties} in Highmaps.
+ *
+ * @requires modules/map
+ *
+ * @sample maps/demo/geojson/
+ *         Simple areas
+ * @sample maps/demo/geojson-multiple-types/
+ *         Multiple types
+ *
+ * @function Highcharts.geojson
+ *
+ * @param {Highcharts.GeoJSON} geojson
+ *        The GeoJSON structure to parse, represented as a JavaScript object
+ *        rather than a JSON string.
+ *
+ * @param {string} [hType=map]
+ *        The Highmaps series type to prepare for. Setting "map" will return
+ *        GeoJSON polygons and multipolygons. Setting "mapline" will return
+ *        GeoJSON linestrings and multilinestrings. Setting "mappoint" will
+ *        return GeoJSON points and multipoints.
+ *
+ * @return {Array<*>}
+ *         An object ready for the `mapData` option.
+ */
+H.geojson = function (geojson, hType, series) {
+    if (hType === void 0) { hType = 'map'; }
+    var mapData = [];
+    var path = [];
+    geojson.features.forEach(function (feature) {
+        var geometry = feature.geometry || {}, type = geometry.type, coordinates = geometry.coordinates, properties = feature.properties, pointOptions;
+        path = [];
+        if ((hType === 'map' || hType === 'mapbubble') &&
+            (type === 'Polygon' || type === 'MultiPolygon')) {
+            if (coordinates.length) {
+                pointOptions = { geometry: { coordinates: coordinates, type: type } };
+            }
+        }
+        else if (hType === 'mapline' &&
+            (type === 'LineString' ||
+                type === 'MultiLineString')) {
+            if (coordinates.length) {
+                pointOptions = { geometry: { coordinates: coordinates, type: type } };
+            }
+        }
+        else if (hType === 'mappoint' && type === 'Point') {
+            if (coordinates.length) {
+                pointOptions = { geometry: { coordinates: coordinates, type: type } };
+            }
+        }
+        if (pointOptions) {
+            mapData.push(extend(pointOptions, {
+                name: properties.name || properties.NAME,
+                /**
+                 * In Highmaps, when data is loaded from GeoJSON, the GeoJSON
+                 * item's properies are copied over here.
+                 *
+                 * @requires modules/map
+                 * @name Highcharts.Point#properties
+                 * @type {*}
+                 */
+                properties: properties
+            }));
+        }
+    });
+    // Create a credits text that includes map source, to be picked up in
+    // Chart.addCredits
+    if (series && geojson.copyrightShort) {
+        series.chart.mapCredits = format(series.chart.options.credits.mapText, { geojson: geojson });
+        series.chart.mapCreditsFull = format(series.chart.options.credits.mapTextFull, { geojson: geojson });
+    }
+    return mapData;
+};
+// Override addCredits to include map source by default
+wrap(Chart.prototype, 'addCredits', function (proceed, credits) {
+    credits = merge(true, this.options.credits, credits);
+    // Disable credits link if map credits enabled. This to allow for in-text
+    // anchors.
+    if (this.mapCredits) {
+        credits.href = null;
+    }
+    proceed.call(this, credits);
+    // Add full map credits to hover
+    if (this.credits && this.mapCreditsFull) {
+        this.credits.attr({
+            title: this.mapCreditsFull
+        });
+    }
+});