highcharts 8.1.0 → 8.2.2

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

@@ -12,7 +12,7 @@ import H from './Globals.js';
 /**
  * An animation configuration. Animation configurations can also be defined as
  * booleans, where `false` turns off animation and `true` defaults to a duration
- * of 500ms.
+ * of 500ms and defer of 0ms.
  *
  * @interface Highcharts.AnimationOptionsObject
  */ /**
@@ -20,6 +20,10 @@ import H from './Globals.js';
 * @name Highcharts.AnimationOptionsObject#complete
 * @type {Function|undefined}
 */ /**
+* The animation defer in milliseconds.
+* @name Highcharts.AnimationOptionsObject#defer
+* @type {number|undefined}
+*/ /**
 * The animation duration in milliseconds.
 * @name Highcharts.AnimationOptionsObject#duration
 * @type {number|undefined}
@@ -181,7 +185,9 @@ import H from './Globals.js';
  */
 /**
  * Generic dictionary in TypeScript notation.
+ * Use the native `Record<string, any>` instead.
  *
+ * @deprecated
  * @interface Highcharts.Dictionary<T>
  */ /**
 * @name Highcharts.Dictionary<T>#[key:string]
@@ -348,15 +354,21 @@ var charts = H.charts, doc = H.doc, win = H.win;
  *
  * @return {void}
  */
-var error = H.error = function (code, stop, chart, params) {
+function error(code, stop, chart, params) {
+    var severity = stop ? 'Highcharts error' : 'Highcharts warning';
+    if (code === 32) {
+        code = severity + ": Deprecated member";
+    }
     var isCode = isNumber(code), message = isCode ?
-        "Highcharts error #" + code + ": www.highcharts.com/errors/" + code + "/" :
+        severity + " #" + code + ": www.highcharts.com/errors/" + code + "/" :
         code.toString(), defaultHandler = function () {
         if (stop) {
             throw new Error(message);
         }
         // else ...
-        if (win.console) {
+        if (win.console &&
+            error.messages.indexOf(message) === -1 // prevent console flooting
+        ) {
             console.log(message); // eslint-disable-line no-console
         }
     };
@@ -366,7 +378,7 @@ var error = H.error = function (code, stop, chart, params) {
             message += '?';
         }
         objectEach(params, function (value, key) {
-            additionalMessages_1 += ('\n' + key + ': ' + value);
+            additionalMessages_1 += "\n - " + key + ": " + value;
             if (isCode) {
                 message += encodeURI(key) + '=' + encodeURI(value);
             }
@@ -379,369 +391,12 @@ var error = H.error = function (code, stop, chart, params) {
     else {
         defaultHandler();
     }
-};
-/* eslint-disable no-invalid-this, valid-jsdoc */
-/**
- * An animator object used internally. One instance applies to one property
- * (attribute or style prop) on one element. Animation is always initiated
- * through {@link SVGElement#animate}.
- *
- * @example
- * var rect = renderer.rect(0, 0, 10, 10).add();
- * rect.animate({ width: 100 });
- *
- * @private
- * @class
- * @name Highcharts.Fx
- */
-var Fx = /** @class */ (function () {
-    /* *
-     *
-     *  Constructors
-     *
-     * */
-    /**
-     *
-     * @param {Highcharts.HTMLDOMElement|Highcharts.SVGElement} elem
-     *        The element to animate.
-     *
-     * @param {Highcharts.AnimationOptionsObject} options
-     *        Animation options.
-     *
-     * @param {string} prop
-     *        The single attribute or CSS property to animate.
-     */
-    function Fx(elem, options, prop) {
-        this.options = options;
-        this.elem = elem;
-        this.prop = prop;
-    }
-    /* *
-     *
-     *  Functions
-     *
-     * */
-    /**
-     * Set the current step of a path definition on SVGElement.
-     *
-     * @function Highcharts.Fx#dSetter
-     *
-     * @return {void}
-     */
-    Fx.prototype.dSetter = function () {
-        var paths = this.paths, start = paths && paths[0], end = paths && paths[1], path = [], now = this.now || 0;
-        // Land on the final path without adjustment points appended in the ends
-        if (now === 1 || !start || !end) {
-            path = this.toD || [];
-        }
-        else if (start.length === end.length && now < 1) {
-            for (var i = 0; i < end.length; i++) {
-                // Tween between the start segment and the end segment. Start
-                // with a copy of the end segment and tween the appropriate
-                // numerics
-                var startSeg = start[i];
-                var endSeg = end[i];
-                var tweenSeg = [];
-                for (var j = 0; j < endSeg.length; j++) {
-                    var startItem = startSeg[j];
-                    var endItem = endSeg[j];
-                    // Tween numbers
-                    if (typeof startItem === 'number' &&
-                        typeof endItem === 'number' &&
-                        // Arc boolean flags
-                        !(endSeg[0] === 'A' && (j === 4 || j === 5))) {
-                        tweenSeg[j] = startItem + now * (endItem - startItem);
-                        // Strings, take directly from the end segment
-                    }
-                    else {
-                        tweenSeg[j] = endItem;
-                    }
-                }
-                path.push(tweenSeg);
-            }
-            // If animation is finished or length not matching, land on right value
-        }
-        else {
-            path = end;
-        }
-        this.elem.attr('d', path, void 0, true);
-    };
-    /**
-     * Update the element with the current animation step.
-     *
-     * @function Highcharts.Fx#update
-     *
-     * @return {void}
-     */
-    Fx.prototype.update = function () {
-        var elem = this.elem, prop = this.prop, // if destroyed, it is null
-        now = this.now, step = this.options.step;
-        // Animation setter defined from outside
-        if (this[prop + 'Setter']) {
-            this[prop + 'Setter']();
-            // Other animations on SVGElement
-        }
-        else if (elem.attr) {
-            if (elem.element) {
-                elem.attr(prop, now, null, true);
-            }
-            // HTML styles, raw HTML content like container size
-        }
-        else {
-            elem.style[prop] = now + this.unit;
-        }
-        if (step) {
-            step.call(elem, now, this);
-        }
-    };
-    /**
-     * Run an animation.
-     *
-     * @function Highcharts.Fx#run
-     *
-     * @param {number} from
-     *        The current value, value to start from.
-     *
-     * @param {number} to
-     *        The end value, value to land on.
-     *
-     * @param {string} unit
-     *        The property unit, for example `px`.
-     *
-     * @return {void}
-     */
-    Fx.prototype.run = function (from, to, unit) {
-        var self = this, options = self.options, timer = function (gotoEnd) {
-            return timer.stopped ? false : self.step(gotoEnd);
-        }, requestAnimationFrame = win.requestAnimationFrame ||
-            function (step) {
-                setTimeout(step, 13);
-            }, step = function () {
-            for (var i = 0; i < H.timers.length; i++) {
-                if (!H.timers[i]()) {
-                    H.timers.splice(i--, 1);
-                }
-            }
-            if (H.timers.length) {
-                requestAnimationFrame(step);
-            }
-        };
-        if (from === to && !this.elem['forceAnimate:' + this.prop]) {
-            delete options.curAnim[this.prop];
-            if (options.complete && Object.keys(options.curAnim).length === 0) {
-                options.complete.call(this.elem);
-            }
-        }
-        else { // #7166
-            this.startTime = +new Date();
-            this.start = from;
-            this.end = to;
-            this.unit = unit;
-            this.now = this.start;
-            this.pos = 0;
-            timer.elem = this.elem;
-            timer.prop = this.prop;
-            if (timer() && H.timers.push(timer) === 1) {
-                requestAnimationFrame(step);
-            }
-        }
-    };
-    /**
-     * Run a single step in the animation.
-     *
-     * @function Highcharts.Fx#step
-     *
-     * @param {boolean} [gotoEnd]
-     *        Whether to go to the endpoint of the animation after abort.
-     *
-     * @return {boolean}
-     *         Returns `true` if animation continues.
-     */
-    Fx.prototype.step = function (gotoEnd) {
-        var t = +new Date(), ret, done, options = this.options, elem = this.elem, complete = options.complete, duration = options.duration, curAnim = options.curAnim;
-        if (elem.attr && !elem.element) { // #2616, element is destroyed
-            ret = false;
-        }
-        else if (gotoEnd || t >= duration + this.startTime) {
-            this.now = this.end;
-            this.pos = 1;
-            this.update();
-            curAnim[this.prop] = true;
-            done = true;
-            objectEach(curAnim, function (val) {
-                if (val !== true) {
-                    done = false;
-                }
-            });
-            if (done && complete) {
-                complete.call(elem);
-            }
-            ret = false;
-        }
-        else {
-            this.pos = options.easing((t - this.startTime) / duration);
-            this.now = this.start + ((this.end - this.start) * this.pos);
-            this.update();
-            ret = true;
-        }
-        return ret;
-    };
-    /**
-     * Prepare start and end values so that the path can be animated one to one.
-     *
-     * @function Highcharts.Fx#initPath
-     *
-     * @param {Highcharts.SVGElement} elem
-     *        The SVGElement item.
-     *
-     * @param {Highcharts.SVGPathArray|undefined} fromD
-     *        Starting path definition.
-     *
-     * @param {Highcharts.SVGPathArray} toD
-     *        Ending path definition.
-     *
-     * @return {Array<Highcharts.SVGPathArray,Highcharts.SVGPathArray>}
-     *         An array containing start and end paths in array form so that
-     *         they can be animated in parallel.
-     */
-    Fx.prototype.initPath = function (elem, fromD, toD) {
-        var shift, startX = elem.startX, endX = elem.endX, fullLength, i, start = fromD && fromD.slice(), // copy
-        end = toD.slice(), // copy
-        isArea = elem.isArea, positionFactor = isArea ? 2 : 1, reverse;
-        if (!start) {
-            return [end, end];
-        }
-        /**
-         * If shifting points, prepend a dummy point to the end path.
-         * @private
-         * @param {Highcharts.SVGPathArray} arr - array
-         * @param {Highcharts.SVGPathArray} other - array
-         * @return {void}
-         */
-        function prepend(arr, other) {
-            while (arr.length < fullLength) {
-                // Move to, line to or curve to?
-                var moveSegment = arr[0], otherSegment = other[fullLength - arr.length];
-                if (otherSegment && moveSegment[0] === 'M') {
-                    if (otherSegment[0] === 'C') {
-                        arr[0] = [
-                            'C',
-                            moveSegment[1],
-                            moveSegment[2],
-                            moveSegment[1],
-                            moveSegment[2],
-                            moveSegment[1],
-                            moveSegment[2]
-                        ];
-                    }
-                    else {
-                        arr[0] = ['L', moveSegment[1], moveSegment[2]];
-                    }
-                }
-                // Prepend a copy of the first point
-                arr.unshift(moveSegment);
-                // For areas, the bottom path goes back again to the left, so we
-                // need to append a copy of the last point.
-                if (isArea) {
-                    arr.push(arr[arr.length - 1]);
-                }
-            }
-        }
-        /**
-         * Copy and append last point until the length matches the end length.
-         * @private
-         * @param {Highcharts.SVGPathArray} arr - array
-         * @param {Highcharts.SVGPathArray} other - array
-         * @return {void}
-         */
-        function append(arr, other) {
-            while (arr.length < fullLength) {
-                // Pull out the slice that is going to be appended or inserted.
-                // In a line graph, the positionFactor is 1, and the last point
-                // is sliced out. In an area graph, the positionFactor is 2,
-                // causing the middle two points to be sliced out, since an area
-                // path starts at left, follows the upper path then turns and
-                // follows the bottom back.
-                var segmentToAdd = arr[arr.length / positionFactor - 1].slice();
-                // Disable the first control point of curve segments
-                if (segmentToAdd[0] === 'C') {
-                    segmentToAdd[1] = segmentToAdd[5];
-                    segmentToAdd[2] = segmentToAdd[6];
-                }
-                if (!isArea) {
-                    arr.push(segmentToAdd);
-                }
-                else {
-                    var lowerSegmentToAdd = arr[arr.length / positionFactor].slice();
-                    arr.splice(arr.length / 2, 0, segmentToAdd, lowerSegmentToAdd);
-                }
-            }
-        }
-        // For sideways animation, find out how much we need to shift to get the
-        // start path Xs to match the end path Xs.
-        if (startX && endX) {
-            for (i = 0; i < startX.length; i++) {
-                // Moving left, new points coming in on right
-                if (startX[i] === endX[0]) {
-                    shift = i;
-                    break;
-                    // Moving right
-                }
-                else if (startX[0] ===
-                    endX[endX.length - startX.length + i]) {
-                    shift = i;
-                    reverse = true;
-                    break;
-                    // Fixed from the right side, "scaling" left
-                }
-                else if (startX[startX.length - 1] ===
-                    endX[endX.length - startX.length + i]) {
-                    shift = startX.length - i;
-                    break;
-                }
-            }
-            if (typeof shift === 'undefined') {
-                start = [];
-            }
-        }
-        if (start.length && isNumber(shift)) {
-            // The common target length for the start and end array, where both
-            // arrays are padded in opposite ends
-            fullLength = end.length + shift * positionFactor;
-            if (!reverse) {
-                prepend(end, start);
-                append(start, end);
-            }
-            else {
-                prepend(start, end);
-                append(end, start);
-            }
-        }
-        return [start, end];
-    };
-    /**
-     * Handle animation of the color attributes directly.
-     *
-     * @function Highcharts.Fx#fillSetter
-     *
-     * @return {void}
-     */
-    Fx.prototype.fillSetter = function () {
-        Fx.prototype.strokeSetter.apply(this, arguments);
-    };
-    /**
-     * Handle animation of the color attributes directly.
-     *
-     * @function Highcharts.Fx#strokeSetter
-     *
-     * @return {void}
-     */
-    Fx.prototype.strokeSetter = function () {
-        this.elem.attr(this.prop, H.color(this.start).tweenTo(H.color(this.end), this.pos), null, true);
-    };
-    return Fx;
-}());
-H.Fx = Fx;
+    error.messages.push(message);
+}
+(function (error) {
+    error.messages = [];
+})(error || (error = {}));
+H.error = error;
 /* eslint-disable valid-jsdoc */
 /**
  * Utility function to deep merge two or more objects and return a third object.
@@ -1263,7 +918,7 @@ var relativeLength = H.relativeLength = function relativeLength(value, base, off
 /**
  * Wrap a method with extended functionality, preserving the original function.
  *
-' * @function Highcharts.wrap
+ * @function Highcharts.wrap
  *
  * @param {*} obj
  *        The context object that the method belongs to. In real cases, this is
@@ -1276,8 +931,6 @@ var relativeLength = H.relativeLength = function relativeLength(value, base, off
  *        A wrapper function callback. This function is called with the same
  *        arguments as the original function, except that the original function
  *        is unshifted and passed as the first argument.
- *
- * @return {void}
  */
 var wrap = H.wrap = function wrap(obj, method, func) {
     var proceed = obj[method];
@@ -1534,8 +1187,6 @@ var arrayMax = H.arrayMax = function arrayMax(data) {
  *
  * @param {*} [except]
  *        Exception, do not destroy this property, only delete it.
- *
- * @return {void}
  */
 var destroyObjectProperties = H.destroyObjectProperties =
     function destroyObjectProperties(obj, except) {
@@ -1556,8 +1207,6 @@ var destroyObjectProperties = H.destroyObjectProperties =
  *
  * @param {Highcharts.HTMLDOMElement} element
  *        The HTML node to discard.
- *
- * @return {void}
  */
 var discardElement = H.discardElement = function discardElement(element) {
     var garbageBin = H.garbageBin;
@@ -1588,45 +1237,6 @@ var discardElement = H.discardElement = function discardElement(element) {
 var correctFloat = H.correctFloat = function correctFloat(num, prec) {
     return parseFloat(num.toPrecision(prec || 14));
 };
-/**
- * Set the global animation to either a given value, or fall back to the given
- * chart's animation option.
- *
- * @function Highcharts.setAnimation
- *
- * @param {boolean|Highcharts.AnimationOptionsObject|undefined} animation
- *        The animation object.
- *
- * @param {Highcharts.Chart} chart
- *        The chart instance.
- *
- * @return {void}
- *
- * @todo
- * This function always relates to a chart, and sets a property on the renderer,
- * so it should be moved to the SVGRenderer.
- */
-var setAnimation = H.setAnimation = function setAnimation(animation, chart) {
-    chart.renderer.globalAnimation = pick(animation, chart.options.chart.animation, true);
-};
-/**
- * Get the animation in object form, where a disabled animation is always
- * returned as `{ duration: 0 }`.
- *
- * @function Highcharts.animObject
- *
- * @param {boolean|Highcharts.AnimationOptionsObject} [animation=0]
- *        An animation setting. Can be an object with duration, complete and
- *        easing properties, or a boolean to enable or disable.
- *
- * @return {Highcharts.AnimationOptionsObject}
- *         An object with at least a duration property.
- */
-var animObject = H.animObject = function animObject(animation) {
-    return isObject(animation) ?
-        merge(animation) :
-        { duration: animation ? 500 : 0 };
-};
 /**
  * The time unit lookup
  *
@@ -1861,6 +1471,7 @@ var getStyle = H.getStyle = function (el, prop, toInt) {
  *         The index within the array, or -1 if not found.
  */
 var inArray = H.inArray = function (item, arr, fromIndex) {
+    error(32, false, void 0, { 'Highcharts.inArray': 'use Array.indexOf' });
     return arr.indexOf(item, fromIndex);
 };
 /* eslint-disable valid-jsdoc */
@@ -1906,7 +1517,10 @@ var find = H.find = Array.prototype.find ?
  * @return {Array<string>}
  *         An array of strings that represents all the properties.
  */
-H.keys = Object.keys;
+H.keys = function (obj) {
+    error(32, false, void 0, { 'Highcharts.keys': 'use Object.keys' });
+    return Object.keys(obj);
+};
 /**
  * Get the element's offset position, corrected for `overflow: auto`.
  *
@@ -1930,36 +1544,6 @@ var offset = H.offset = function offset(el) {
             (docElem.clientLeft || 0)
     };
 };
-/**
- * Stop running animation.
- *
- * @function Highcharts.stop
- *
- * @param {Highcharts.SVGElement} el
- *        The SVGElement to stop animation on.
- *
- * @param {string} [prop]
- *        The property to stop animating. If given, the stop method will stop a
- *        single property from animating, while others continue.
- *
- * @return {void}
- *
- * @todo
- * A possible extension to this would be to stop a single property, when
- * we want to continue animating others. Then assign the prop to the timer
- * in the Fx.run method, and check for the prop here. This would be an
- * improvement in all cases where we stop the animation from .attr. Instead of
- * stopping everything, we can just stop the actual attributes we're setting.
- */
-var stop = H.stop = function (el, prop) {
-    var i = H.timers.length;
-    // Remove timers related to this element (#4519)
-    while (i--) {
-        if (H.timers[i].elem === el && (!prop || prop === H.timers[i].prop)) {
-            H.timers[i].stopped = true; // #4667
-        }
-    }
-};
 /* eslint-disable valid-jsdoc */
 /**
  * Iterate over object key pairs in an object.
@@ -2086,6 +1670,8 @@ objectEach({
     some: 'some'
 }, function (val, key) {
     H[key] = function (arr) {
+        var _a;
+        error(32, false, void 0, (_a = {}, _a["Highcharts." + key] = "use Array." + val, _a));
         return Array.prototype[val].apply(arr, [].slice.call(arguments, 1));
     };
 });
@@ -2204,7 +1790,7 @@ var removeEvent = H.removeEvent = function removeEvent(el, type, fn) {
         else {
             types = eventCollection;
         }
-        objectEach(types, function (val, n) {
+        objectEach(types, function (_val, n) {
             if (eventCollection[n]) {
                 len = eventCollection[n].length;
                 while (len--) {
@@ -2323,113 +1909,7 @@ var fireEvent = H.fireEvent = function (el, type, eventArguments, defaultFunctio
         defaultFunction.call(el, eventArguments);
     }
 };
-/**
- * The global animate method, which uses Fx to create individual animators.
- *
- * @function Highcharts.animate
- *
- * @param {Highcharts.HTMLDOMElement|Highcharts.SVGElement} el
- *        The element to animate.
- *
- * @param {Highcharts.CSSObject|Highcharts.SVGAttributes} params
- *        An object containing key-value pairs of the properties to animate.
- *        Supports numeric as pixel-based CSS properties for HTML objects and
- *        attributes for SVGElements.
- *
- * @param {Highcharts.AnimationOptionsObject} [opt]
- *        Animation options.
- *
- * @return {void}
- */
-var animate = H.animate = function (el, params, opt) {
-    var start, unit = '', end, fx, args;
-    if (!isObject(opt)) { // Number or undefined/null
-        args = arguments;
-        opt = {
-            duration: args[2],
-            easing: args[3],
-            complete: args[4]
-        };
-    }
-    if (!isNumber(opt.duration)) {
-        opt.duration = 400;
-    }
-    opt.easing = typeof opt.easing === 'function' ?
-        opt.easing :
-        (Math[opt.easing] || Math.easeInOutSine);
-    opt.curAnim = merge(params);
-    objectEach(params, function (val, prop) {
-        // Stop current running animation of this property
-        stop(el, prop);
-        fx = new Fx(el, opt, prop);
-        end = null;
-        if (prop === 'd' && isArray(params.d)) {
-            fx.paths = fx.initPath(el, el.pathArray, params.d);
-            fx.toD = params.d;
-            start = 0;
-            end = 1;
-        }
-        else if (el.attr) {
-            start = el.attr(prop);
-        }
-        else {
-            start = parseFloat(getStyle(el, prop)) || 0;
-            if (prop !== 'opacity') {
-                unit = 'px';
-            }
-        }
-        if (!end) {
-            end = val;
-        }
-        if (end && end.match && end.match('px')) {
-            end = end.replace(/px/g, ''); // #4351
-        }
-        fx.run(start, end, unit);
-    });
-};
-/**
- * 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
-var seriesType = H.seriesType = function (type, parent, options, props, pointProps) {
-    var defaultOptions = H.getOptions(), seriesTypes = H.seriesTypes;
-    // Merge the options
-    defaultOptions.plotOptions[type] = merge(defaultOptions.plotOptions[parent], options);
-    // Create the class
-    seriesTypes[type] = extendClass(seriesTypes[parent] || function () { }, props);
-    seriesTypes[type].prototype.type = type;
-    // Create the point class if needed
-    if (pointProps) {
-        seriesTypes[type].prototype.pointClass =
-            extendClass(H.Point, pointProps);
-    }
-    return seriesTypes[type];
-};
+var serialMode;
 /**
  * Get a unique key for using in internal element id's and pointers. The key is
  * composed of a random hash specific to this Highcharts instance, and a
@@ -2441,17 +1921,81 @@ var seriesType = H.seriesType = function (type, parent, options, props, pointPro
  * @function Highcharts.uniqueKey
  *
  * @return {string}
- *         A unique key.
+ * A unique key.
  */
 var uniqueKey = H.uniqueKey = (function () {
-    var uniqueKeyHash = Math.random().toString(36).substring(2, 9), idCounter = 0;
+    var hash = Math.random().toString(36).substring(2, 9) + '-';
+    var id = 0;
     return function () {
-        return 'highcharts-' + uniqueKeyHash + '-' + idCounter++;
+        return 'highcharts-' + (serialMode ? '' : hash) + id++;
     };
 }());
+/**
+ * Activates a serial mode for element IDs provided by
+ * {@link Highcharts.uniqueKey}. This mode can be used in automated tests, where
+ * a simple comparison of two rendered SVG graphics is needed.
+ *
+ * **Note:** This is only for testing purposes and will break functionality in
+ * webpages with multiple charts.
+ *
+ * @example
+ * if (
+ *   process &&
+ *   process.env.NODE_ENV === 'development'
+ * ) {
+ *   Highcharts.useSerialIds(true);
+ * }
+ *
+ * @function Highcharts.useSerialIds
+ *
+ * @param {boolean} [mode]
+ * Changes the state of serial mode.
+ *
+ * @return {boolean|undefined}
+ * State of the serial mode.
+ */
+var useSerialIds = H.useSerialIds = function (mode) {
+    return (serialMode = pick(mode, serialMode));
+};
 var isFunction = H.isFunction = function (obj) {
     return typeof obj === 'function';
 };
+/**
+ * Get the updated default options. Until 3.0.7, merely exposing defaultOptions
+ * for outside modules wasn't enough because the setOptions method created a new
+ * object.
+ *
+ * @function Highcharts.getOptions
+ *
+ * @return {Highcharts.Options}
+ */
+var getOptions = H.getOptions = function () {
+    return H.defaultOptions;
+};
+/**
+ * Merge the default options with custom options and return the new options
+ * structure. Commonly used for defining reusable templates.
+ *
+ * @sample highcharts/global/useutc-false Setting a global option
+ * @sample highcharts/members/setoptions Applying a global theme
+ *
+ * @function Highcharts.setOptions
+ *
+ * @param {Highcharts.Options} options
+ *        The new custom chart options.
+ *
+ * @return {Highcharts.Options}
+ *         Updated options.
+ */
+var setOptions = H.setOptions = function (options) {
+    // Copy in the default options
+    H.defaultOptions = merge(true, H.defaultOptions, options);
+    // Update the time object
+    if (options.time || options.global) {
+        H.time.update(merge(H.defaultOptions.global, H.defaultOptions.time, options.global, options.time));
+    }
+    return H.defaultOptions;
+};
 // Register Highcharts as a plugin in jQuery
 if (win.jQuery) {
     /**
@@ -2506,10 +2050,7 @@ if (win.jQuery) {
 }
 // TODO use named exports when supported.
 var utilitiesModule = {
-    Fx: H.Fx,
     addEvent: addEvent,
-    animate: animate,
-    animObject: animObject,
     arrayMax: arrayMax,
     arrayMin: arrayMin,
     attr: attr,
@@ -2530,6 +2071,7 @@ var utilitiesModule = {
     format: format,
     getMagnitude: getMagnitude,
     getNestedProperty: getNestedProperty,
+    getOptions: getOptions,
     getStyle: getStyle,
     inArray: inArray,
     isArray: isArray,
@@ -2549,14 +2091,13 @@ var utilitiesModule = {
     pInt: pInt,
     relativeLength: relativeLength,
     removeEvent: removeEvent,
-    seriesType: seriesType,
-    setAnimation: setAnimation,
+    setOptions: setOptions,
     splat: splat,
     stableSort: stableSort,
-    stop: stop,
     syncTimeout: syncTimeout,
     timeUnits: timeUnits,
     uniqueKey: uniqueKey,
+    useSerialIds: useSerialIds,
     wrap: wrap
 };
 export default utilitiesModule;