highcharts 8.1.0 → 8.2.2

package/es-modules/{parts-3d/SVGRenderer.js → Core/Renderer/SVG/SVGRenderer3D.js}

@@ -9,14 +9,19 @@
  *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
  *
  * */
-'use strict';
-import H from '../parts/Globals.js';
-import U from '../parts/Utilities.js';
-var animObject = U.animObject, defined = U.defined, extend = U.extend, merge = U.merge, objectEach = U.objectEach, pick = U.pick;
-import '../parts/Color.js';
-import '../parts/SvgRenderer.js';
+import A from '../../Animation/AnimationUtilities.js';
+var animObject = A.animObject;
+import Color from '../../Color/Color.js';
+var color = Color.parse;
+import H from '../../Globals.js';
+import Math3D from '../../../Extensions/Math3D.js';
+var perspective = Math3D.perspective, shapeArea = Math3D.shapeArea;
+import SVGElement from './SVGElement.js';
+import SVGRenderer from './SVGRenderer.js';
+import U from '../../Utilities.js';
+var defined = U.defined, extend = U.extend, merge = U.merge, objectEach = U.objectEach, pick = U.pick;
 var cos = Math.cos, PI = Math.PI, sin = Math.sin;
-var charts = H.charts, color = H.color, deg2rad = H.deg2rad, perspective = H.perspective, SVGElement = H.SVGElement, SVGRenderer = H.SVGRenderer, 
+var charts = H.charts, deg2rad = H.deg2rad, 
 // internal:
 dFactor, element3dMethods, cuboidMethods;
 /*
@@ -98,7 +103,7 @@ SVGRenderer.prototype.face3d = function (args) {
             delete hash.enabled;
             delete hash.vertexes;
             delete hash.insidePlotArea;
-            var chart = charts[renderer.chartIndex], vertexes2d = perspective(this.vertexes, chart, this.insidePlotArea), path = renderer.toLinePath(vertexes2d, true), area = H.shapeArea(vertexes2d), visibility = (this.enabled && area > 0) ? 'visible' : 'hidden';
+            var chart = charts[renderer.chartIndex], vertexes2d = perspective(this.vertexes, chart, this.insidePlotArea), path = renderer.toLinePath(vertexes2d, true), area = shapeArea(vertexes2d), visibility = (this.enabled && area > 0) ? 'visible' : 'hidden';
             hash.d = path;
             hash.visibility = visibility;
         }
@@ -115,7 +120,7 @@ SVGRenderer.prototype.face3d = function (args) {
             delete params.enabled;
             delete params.vertexes;
             delete params.insidePlotArea;
-            var chart = charts[renderer.chartIndex], vertexes2d = perspective(this.vertexes, chart, this.insidePlotArea), path = renderer.toLinePath(vertexes2d, true), area = H.shapeArea(vertexes2d), visibility = (this.enabled && area > 0) ? 'visible' : 'hidden';
+            var chart = charts[renderer.chartIndex], vertexes2d = perspective(this.vertexes, chart, this.insidePlotArea), path = renderer.toLinePath(vertexes2d, true), area = shapeArea(vertexes2d), visibility = (this.enabled && area > 0) ? 'visible' : 'hidden';
             params.d = path;
             this.attr('visibility', visibility);
         }
@@ -331,7 +336,7 @@ SVGRenderer.prototype.cuboid = function (shapeArgs) {
     return this.element3d('cuboid', shapeArgs);
 };
 // Generates a cuboid path and zIndexes
-H.SVGRenderer.prototype.cuboidPath = function (shapeArgs) {
+SVGRenderer.prototype.cuboidPath = function (shapeArgs) {
     var x = shapeArgs.x, y = shapeArgs.y, z = shapeArgs.z || 0, 
     // For side calculation (right/left)
     // there is a need for height (and other shapeArgs arguments)
@@ -447,18 +452,18 @@ H.SVGRenderer.prototype.cuboidPath = function (shapeArgs) {
         // but if cuboid height is 0 additional height is added so it is
         // possible to use this vertices array for visible face calculation
         dummyFace1 = verticesIndex1.map(mapSidePath), dummyFace2 = verticesIndex2.map(mapSidePath);
-        if (H.shapeArea(face1) < 0) {
+        if (shapeArea(face1) < 0) {
             ret = [face1, 0];
         }
-        else if (H.shapeArea(face2) < 0) {
+        else if (shapeArea(face2) < 0) {
             ret = [face2, 1];
         }
         else if (side) {
             forcedSides.push(side);
-            if (H.shapeArea(dummyFace1) < 0) {
+            if (shapeArea(dummyFace1) < 0) {
                 ret = [face1, 0];
             }
-            else if (H.shapeArea(dummyFace2) < 0) {
+            else if (shapeArea(dummyFace2) < 0) {
                 ret = [face2, 1];
             }
             else {
@@ -525,7 +530,7 @@ H.SVGRenderer.prototype.cuboidPath = function (shapeArgs) {
     }; // #4774
 };
 // SECTORS //
-H.SVGRenderer.prototype.arc3d = function (attribs) {
+SVGRenderer.prototype.arc3d = function (attribs) {
     var wrapper = this.g(), renderer = wrapper.renderer, customAttribs = ['x', 'y', 'r', 'innerR', 'start', 'end', 'depth'];
     /**
      * Get custom attributes. Don't mutate the original object and return an
@@ -542,7 +547,7 @@ H.SVGRenderer.prototype.arc3d = function (attribs) {
                 hasCA = true;
             }
         }
-        return hasCA ? ca : false;
+        return hasCA ? [ca, params] : false;
     }
     attribs = merge(attribs);
     attribs.alpha = (attribs.alpha || 0) * deg2rad;
@@ -624,10 +629,12 @@ H.SVGRenderer.prototype.arc3d = function (attribs) {
     });
     // Override attr to remove shape attributes and use those to set child paths
     wrapper.attr = function (params) {
-        var ca;
+        var ca, paramArr;
         if (typeof params === 'object') {
-            ca = suckOutCustom(params);
-            if (ca) {
+            paramArr = suckOutCustom(params);
+            if (paramArr) {
+                ca = paramArr[0];
+                arguments[0] = paramArr[1];
                 extend(wrapper.attribs, ca);
                 wrapper.setPaths(wrapper.attribs);
             }
@@ -637,7 +644,7 @@ H.SVGRenderer.prototype.arc3d = function (attribs) {
     // Override the animate function by sucking out custom parameters related to
     // the shapes directly, and update the shapes from the animation step.
     wrapper.animate = function (params, animation, complete) {
-        var ca, from = this.attribs, to, anim, randomProp = 'data-' + Math.random().toString(26).substring(2, 9);
+        var paramArr, from = this.attribs, to, anim, randomProp = 'data-' + Math.random().toString(26).substring(2, 9);
         // Attribute-line properties connected to 3D. These shouldn't have been
         // in the attribs collection in the first place.
         delete params.center;
@@ -646,14 +653,14 @@ H.SVGRenderer.prototype.arc3d = function (attribs) {
         delete params.beta;
         anim = animObject(pick(animation, this.renderer.globalAnimation));
         if (anim.duration) {
-            ca = suckOutCustom(params);
+            paramArr = suckOutCustom(params);
             // Params need to have a property in order for the step to run
             // (#5765, #7097, #7437)
             wrapper[randomProp] = 0;
             params[randomProp] = 1;
             wrapper[randomProp + 'Setter'] = H.noop;
-            if (ca) {
-                to = ca;
+            if (paramArr) {
+                to = paramArr[0]; // custom attr
                 anim.step = function (a, fx) {
                     /**
                      * @private
@@ -874,3 +881,4 @@ SVGRenderer.prototype.arc3dPath = function (shapeArgs) {
         zSide2: a2 * 0.99
     };
 };
+export default SVGRenderer;

package/es-modules/{parts → Core}/Responsive.js

@@ -8,7 +8,9 @@
  *
  * */
 'use strict';
-import H from './Globals.js';
+import Chart from './Chart/Chart.js';
+import U from './Utilities.js';
+var find = U.find, isArray = U.isArray, isObject = U.isObject, merge = U.merge, objectEach = U.objectEach, pick = U.pick, splat = U.splat, uniqueKey = U.uniqueKey;
 /**
  * A callback function to gain complete control on when the responsive rule
  * applies.
@@ -21,10 +23,6 @@ import H from './Globals.js';
  * @return {boolean}
  *         Return `true` if it applies.
  */
-import './Chart.js';
-import U from './Utilities.js';
-var find = U.find, isArray = U.isArray, isObject = U.isObject, merge = U.merge, objectEach = U.objectEach, pick = U.pick, splat = U.splat, uniqueKey = U.uniqueKey;
-var Chart = H.Chart;
 /**
  * Allows setting a set of rules to apply for different screen or chart
  * sizes. Each rule specifies additional chart options.
@@ -141,9 +139,8 @@ var Chart = H.Chart;
  * @function Highcharts.Chart#setResponsive
  * @param  {boolean} [redraw=true]
  * @param  {boolean} [reset=false]
- *         Reset by un-applying all rules. Chart.update resets all rules before
- *         applying updated options.
- * @return {void}
+ * Reset by un-applying all rules. Chart.update resets all rules before applying
+ * updated options.
  */
 Chart.prototype.setResponsive = function (redraw, reset) {
     var options = this.options.responsive, ruleIds = [], currentResponsive = this.currentResponsive, currentRuleIds, undoOptions;
@@ -195,7 +192,6 @@ Chart.prototype.setResponsive = function (redraw, reset) {
  * @function Highcharts.Chart#matchResponsiveRule
  * @param {Highcharts.ResponsiveRulesOptions} rule
  * @param {Array<string>} matches
- * @return {void}
  */
 Chart.prototype.matchResponsiveRule = function (rule, matches) {
     var condition = rule.condition, fn = condition.callback || function () {
@@ -212,7 +208,10 @@ Chart.prototype.matchResponsiveRule = function (rule, matches) {
 /**
  * Get the current values for a given set of options. Used before we update
  * the chart with a new responsiveness rule.
- * TODO: Restore axis options (by id?)
+ *
+ * @todo Restore axis options (by id?). The matching of items in collections
+ * bears resemblance to the oneToOne matching in Chart.update. Probably we can
+ * refactor out that matching and reuse it in both functions.
  *
  * @private
  * @function Highcharts.Chart#currentOptions
@@ -234,10 +233,21 @@ Chart.prototype.currentOptions = function (options) {
                 ret[key] = [];
                 // Iterate over collections like series, xAxis or yAxis and map
                 // the items by index.
-                for (i = 0; i < val.length; i++) {
-                    if (curr[key][i]) { // Item exists in current data (#6347)
-                        ret[key][i] = {};
-                        getCurrent(val[i], curr[key][i], ret[key][i], depth + 1);
+                for (i = 0; i < Math.max(val.length, curr[key].length); i++) {
+                    // Item exists in current data (#6347)
+                    if (curr[key][i]) {
+                        // If the item is missing from the new data, we need to
+                        // save the whole config structure. Like when
+                        // responsively updating from a dual axis layout to a
+                        // single axis and back (#13544).
+                        if (val[i] === void 0) {
+                            ret[key][i] = curr[key][i];
+                            // Otherwise, proceed
+                        }
+                        else {
+                            ret[key][i] = {};
+                            getCurrent(val[i], curr[key][i], ret[key][i], depth + 1);
+                        }
                     }
                 }
             }

package/es-modules/{parts → Core}/Scrollbar.js

@@ -8,13 +8,14 @@
  *
  * */
 'use strict';
-import Axis from './Axis.js';
+import Axis from './Axis/Axis.js';
 import H from './Globals.js';
-import ScrollbarAxis from './ScrollbarAxis.js';
+import ScrollbarAxis from './Axis/ScrollbarAxis.js';
 import U from './Utilities.js';
 var addEvent = U.addEvent, correctFloat = U.correctFloat, defined = U.defined, destroyObjectProperties = U.destroyObjectProperties, fireEvent = U.fireEvent, merge = U.merge, pick = U.pick, removeEvent = U.removeEvent;
-import './Options.js';
-var defaultOptions = H.defaultOptions, hasTouch = H.hasTouch, isTouchDevice = H.isTouchDevice;
+import O from './Options.js';
+var defaultOptions = O.defaultOptions;
+var hasTouch = H.hasTouch, isTouchDevice = H.isTouchDevice;
 /**
  * When we have vertical scrollbar, rifles and arrow in buttons should be
  * rotated. The same method is used in Navigator's handles, to rotate them.

package/es-modules/Core/Series/BaseSeries.js

@@ -0,0 +1,157 @@
+/* *
+ *
+ *  (c) 2010-2020 Torstein Honsi
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+import H from '../Globals.js';
+import Point from './Point.js';
+import U from '../Utilities.js';
+var error = U.error, extendClass = U.extendClass, fireEvent = U.fireEvent, getOptions = U.getOptions, isObject = U.isObject, merge = U.merge, objectEach = U.objectEach;
+/**
+ * @class
+ * @name Highcharts.Series
+ */
+var BaseSeries = /** @class */ (function () {
+    /* *
+     *
+     *  Constructor
+     *
+     * */
+    function BaseSeries(chart, options) {
+        var mergedOptions = merge(BaseSeries.defaultOptions, options);
+        this.chart = chart;
+        this._i = chart.series.length;
+        chart.series.push(this);
+        this.options = mergedOptions;
+        this.userOptions = merge(options);
+    }
+    /* *
+     *
+     *  Static Functions
+     *
+     * */
+    BaseSeries.addSeries = function (seriesName, seriesType) {
+        BaseSeries.seriesTypes[seriesName] = seriesType;
+    };
+    BaseSeries.cleanRecursively = function (toClean, reference) {
+        var clean = {};
+        objectEach(toClean, function (_val, key) {
+            var ob;
+            // Dive into objects (except DOM nodes)
+            if (isObject(toClean[key], true) &&
+                !toClean.nodeType && // #10044
+                reference[key]) {
+                ob = BaseSeries.cleanRecursively(toClean[key], reference[key]);
+                if (Object.keys(ob).length) {
+                    clean[key] = ob;
+                }
+                // Arrays, primitives and DOM nodes are copied directly
+            }
+            else if (isObject(toClean[key]) ||
+                toClean[key] !== reference[key]) {
+                clean[key] = toClean[key];
+            }
+        });
+        return clean;
+    };
+    // eslint-disable-next-line valid-jsdoc
+    /**
+     * Internal function to initialize an individual series.
+     * @private
+     */
+    BaseSeries.getSeries = function (chart, options) {
+        if (options === void 0) { options = {}; }
+        var optionsChart = chart.options.chart, type = (options.type ||
+            optionsChart.type ||
+            optionsChart.defaultSeriesType ||
+            ''), Series = BaseSeries.seriesTypes[type];
+        // No such series type
+        if (!Series) {
+            error(17, true, chart, { missingModuleFor: type });
+        }
+        return new Series(chart, options);
+    };
+    /**
+     * Factory to create new series prototypes.
+     *
+     * @function Highcharts.seriesType
+     *
+     * @param {string} type
+     * The series type name.
+     *
+     * @param {string} parent
+     * The parent series type name. Use `line` to inherit from the basic
+     * {@link Series} object.
+     *
+     * @param {Highcharts.SeriesOptionsType|Highcharts.Dictionary<*>} options
+     * The additional default options that are merged with the parent's options.
+     *
+     * @param {Highcharts.Dictionary<*>} [props]
+     * The properties (functions and primitives) to set on the new prototype.
+     *
+     * @param {Highcharts.Dictionary<*>} [pointProps]
+     * Members for a series-specific extension of the {@link Point} prototype if
+     * needed.
+     *
+     * @return {Highcharts.Series}
+     * The newly created prototype as extended from {@link Series} or its
+     * derivatives.
+     */
+    // docs: add to API + extending Highcharts
+    BaseSeries.seriesType = function (type, parent, options, seriesProto, pointProto) {
+        var defaultOptions = getOptions().plotOptions || {}, seriesTypes = BaseSeries.seriesTypes;
+        parent = parent || '';
+        // Merge the options
+        defaultOptions[type] = merge(defaultOptions[parent], options);
+        // Create the class
+        BaseSeries.addSeries(type, extendClass(seriesTypes[parent] || function () { }, seriesProto));
+        seriesTypes[type].prototype.type = type;
+        // Create the point class if needed
+        if (pointProto) {
+            seriesTypes[type].prototype.pointClass =
+                extendClass(Point, pointProto);
+        }
+        return seriesTypes[type];
+    };
+    BaseSeries.prototype.update = function (newOptions, redraw) {
+        if (redraw === void 0) { redraw = true; }
+        var series = this;
+        newOptions = BaseSeries.cleanRecursively(newOptions, this.userOptions);
+        var newType = newOptions.type;
+        if (typeof newType !== 'undefined' &&
+            newType !== series.type) {
+            series = BaseSeries.getSeries(series.chart, newOptions);
+        }
+        fireEvent(series, 'update', { newOptions: newOptions });
+        series.userOptions = merge(newOptions);
+        fireEvent(series, 'afterUpdate', { newOptions: newOptions });
+        if (redraw) {
+            series.chart.redraw();
+        }
+        return series;
+    };
+    /* *
+     *
+     *  Static Properties
+     *
+     * */
+    BaseSeries.defaultOptions = {
+        type: 'base'
+    };
+    BaseSeries.seriesTypes = {};
+    return BaseSeries;
+}());
+BaseSeries.prototype.pointClass = Point;
+// backwards compatibility
+H.seriesType = BaseSeries.seriesType;
+H.seriesTypes = BaseSeries.seriesTypes;
+/* *
+ *
+ *  Export
+ *
+ * */
+export default BaseSeries;