highcharts 9.3.3 → 10.2.0

package/modules/exporting.src.js

@@ -1,5 +1,5 @@
 /**
- * @license Highcharts JS v9.3.3 (2022-02-01)
+ * @license Highcharts JS v10.2.0 (2022-07-05)
  *
  * Exporting module
  *
@@ -7,7 +7,6 @@
  *
  * License: www.highcharts.com/license
  */
-'use strict';
 (function (factory) {
     if (typeof module === 'object' && module.exports) {
         factory['default'] = factory;
@@ -22,10 +21,20 @@
         factory(typeof Highcharts !== 'undefined' ? Highcharts : undefined);
     }
 }(function (Highcharts) {
+    'use strict';
     var _modules = Highcharts ? Highcharts._modules : {};
     function _registerModule(obj, path, args, fn) {
         if (!obj.hasOwnProperty(path)) {
             obj[path] = fn.apply(null, args);
+
+            if (typeof CustomEvent === 'function') {
+                window.dispatchEvent(
+                    new CustomEvent(
+                        'HighchartsModuleLoaded',
+                        { detail: { path: path, module: obj[path] }
+                    })
+                );
+            }
         }
     }
     _registerModule(_modules, 'Extensions/FullScreen.js', [_modules['Core/Chart/Chart.js'], _modules['Core/Globals.js'], _modules['Core/Renderer/HTML/AST.js'], _modules['Core/Utilities.js']], function (Chart, H, AST, U) {
@@ -37,7 +46,8 @@
          * License: www.highcharts.com/license
          */
         var doc = H.doc;
-        var addEvent = U.addEvent;
+        var addEvent = U.addEvent,
+            fireEvent = U.fireEvent;
         /**
          * The module allows user to enable display chart in full screen mode.
          * Used in StockTools too.
@@ -129,26 +139,30 @@
                 var fullscreen = this,
                     chart = fullscreen.chart,
                     optionsChart = chart.options.chart;
-                // Don't fire exitFullscreen() when user exited using 'Escape' button.
-                if (fullscreen.isOpen &&
-                    fullscreen.browserProps &&
-                    chart.container.ownerDocument instanceof Document) {
-                    chart.container.ownerDocument[fullscreen.browserProps.exitFullscreen]();
-                }
-                // Unbind event as it's necessary only before exiting from fullscreen.
-                if (fullscreen.unbindFullscreenEvent) {
-                    fullscreen.unbindFullscreenEvent = fullscreen
-                        .unbindFullscreenEvent();
-                }
-                chart.setSize(fullscreen.origWidth, fullscreen.origHeight, false);
-                fullscreen.origWidth = void 0;
-                fullscreen.origHeight = void 0;
-                optionsChart.width = fullscreen.origWidthOption;
-                optionsChart.height = fullscreen.origHeightOption;
-                fullscreen.origWidthOption = void 0;
-                fullscreen.origHeightOption = void 0;
-                fullscreen.isOpen = false;
-                fullscreen.setButtonText();
+                fireEvent(chart, 'fullscreenClose', null, function () {
+                    // Don't fire exitFullscreen() when user exited
+                    // using 'Escape' button.
+                    if (fullscreen.isOpen &&
+                        fullscreen.browserProps &&
+                        chart.container.ownerDocument instanceof Document) {
+                        chart.container.ownerDocument[fullscreen.browserProps.exitFullscreen]();
+                    }
+                    // Unbind event as it's necessary only before exiting
+                    // from fullscreen.
+                    if (fullscreen.unbindFullscreenEvent) {
+                        fullscreen.unbindFullscreenEvent = fullscreen
+                            .unbindFullscreenEvent();
+                    }
+                    chart.setSize(fullscreen.origWidth, fullscreen.origHeight, false);
+                    fullscreen.origWidth = void 0;
+                    fullscreen.origHeight = void 0;
+                    optionsChart.width = fullscreen.origWidthOption;
+                    optionsChart.height = fullscreen.origHeightOption;
+                    fullscreen.origWidthOption = void 0;
+                    fullscreen.origHeightOption = void 0;
+                    fullscreen.isOpen = false;
+                    fullscreen.setButtonText();
+                });
             };
             /**
              * Displays the chart in fullscreen mode.
@@ -166,43 +180,46 @@
                 var fullscreen = this,
                     chart = fullscreen.chart,
                     optionsChart = chart.options.chart;
-                if (optionsChart) {
-                    fullscreen.origWidthOption = optionsChart.width;
-                    fullscreen.origHeightOption = optionsChart.height;
-                }
-                fullscreen.origWidth = chart.chartWidth;
-                fullscreen.origHeight = chart.chartHeight;
-                // Handle exitFullscreen() method when user clicks 'Escape' button.
-                if (fullscreen.browserProps) {
-                    var unbindChange_1 = addEvent(chart.container.ownerDocument, // chart's document
-                        fullscreen.browserProps.fullscreenChange,
-                        function () {
-                            // Handle lack of async of browser's fullScreenChange event.
-                            if (fullscreen.isOpen) {
-                                fullscreen.isOpen = false;
-                            fullscreen.close();
-                        }
-                        else {
-                            chart.setSize(null, null, false);
-                            fullscreen.isOpen = true;
-                            fullscreen.setButtonText();
-                        }
-                    });
-                    var unbindDestroy_1 = addEvent(chart, 'destroy',
-                        unbindChange_1);
-                    fullscreen.unbindFullscreenEvent = function () {
-                        unbindChange_1();
-                        unbindDestroy_1();
-                    };
-                    var promise = chart.renderTo[fullscreen.browserProps.requestFullscreen]();
-                    if (promise) {
-                        // No dot notation because of IE8 compatibility
-                        promise['catch'](function () {
-                            alert(// eslint-disable-line no-alert
-                            'Full screen is not supported inside a frame.');
+                fireEvent(chart, 'fullscreenOpen', null, function () {
+                    if (optionsChart) {
+                        fullscreen.origWidthOption = optionsChart.width;
+                        fullscreen.origHeightOption = optionsChart.height;
+                    }
+                    fullscreen.origWidth = chart.chartWidth;
+                    fullscreen.origHeight = chart.chartHeight;
+                    // Handle exitFullscreen() method when user clicks 'Escape' button.
+                    if (fullscreen.browserProps) {
+                        var unbindChange_1 = addEvent(chart.container.ownerDocument, // chart's document
+                            fullscreen.browserProps.fullscreenChange,
+                            function () {
+                                // Handle lack of async of browser's
+                                // fullScreenChange event.
+                                if (fullscreen.isOpen) {
+                                    fullscreen.isOpen = false;
+                                fullscreen.close();
+                            }
+                            else {
+                                chart.setSize(null, null, false);
+                                fullscreen.isOpen = true;
+                                fullscreen.setButtonText();
+                            }
                         });
+                        var unbindDestroy_1 = addEvent(chart, 'destroy',
+                            unbindChange_1);
+                        fullscreen.unbindFullscreenEvent = function () {
+                            unbindChange_1();
+                            unbindDestroy_1();
+                        };
+                        var promise = chart.renderTo[fullscreen.browserProps.requestFullscreen]();
+                        if (promise) {
+                            // No dot notation because of IE8 compatibility
+                            promise['catch'](function () {
+                                alert(// eslint-disable-line no-alert
+                                'Full screen is not supported inside a frame.');
+                            });
+                        }
                     }
-                }
+                });
             };
             /**
              * Replaces the exporting context button's text when toogling the
@@ -273,6 +290,66 @@
              */
             this.fullscreen = new H.Fullscreen(this);
         });
+        /* *
+         *
+         *  API Declarations
+         *
+         * */
+        /**
+         * Gets fired when closing the fullscreen
+         *
+         * @callback Highcharts.FullScreenfullscreenCloseCallbackFunction
+         *
+         * @param {Highcharts.Chart} chart
+         *        The chart on which the event occured.
+         *
+         * @param {global.Event} event
+         *        The event that occured.
+         */
+        /**
+         * Gets fired when opening the fullscreen
+         *
+         * @callback Highcharts.FullScreenfullscreenOpenCallbackFunction
+         *
+         * @param {Highcharts.Chart} chart
+         *        The chart on which the event occured.
+         *
+         * @param {global.Event} event
+         *        The event that occured.
+         */
+        /* *
+         *
+         *  API Options
+         *
+         * */
+        /**
+         * Fires when a fullscreen is closed through the context menu item,
+         * or a fullscreen is closed on the `Escape` button click,
+         * or the `Chart.fullscreen.close` method.
+         *
+         * @sample highcharts/chart/events-fullscreen
+         *         Title size change on fullscreen open
+         *
+         * @type      {Highcharts.FullScreenfullscreenCloseCallbackFunction}
+         * @since 10.1.0
+         * @context   Highcharts.Chart
+         * @requires  modules/full-screen
+         * @apioption chart.events.fullscreenClose
+         */
+        /**
+         * Fires when a fullscreen is opened through the context menu item,
+         * or the `Chart.fullscreen.open` method.
+         *
+         * @sample highcharts/chart/events-fullscreen
+         *         Title size change on fullscreen open
+         *
+         * @type      {Highcharts.FullScreenfullscreenOpenCallbackFunction}
+         * @since 10.1.0
+         * @context   Highcharts.Chart
+         * @requires  modules/full-screen
+         * @apioption chart.events.fullscreenOpen
+         */
+        (''); // keeps doclets above in transpiled file
 
         return H.Fullscreen;
     });
@@ -503,7 +580,7 @@
                  * Path where Highcharts will look for export module dependencies to
                  * load on demand if they don't already exist on `window`. Should currently
                  * point to location of [CanVG](https://github.com/canvg/canvg) library,
-                 * [jsPDF](https://github.com/yWorks/jsPDF) and
+                 * [jsPDF](https://github.com/parallax/jsPDF) and
                  * [svg2pdf.js](https://github.com/yWorks/svg2pdf.js), required for client
                  * side export in certain browsers.
                  *
@@ -567,6 +644,54 @@
                  * @since 2.0
                  */
                 url: 'https://export.highcharts.com/',
+                /**
+                 * Settings for a custom font for the exported PDF, when using the
+                 * `offline-exporting` module. This is used for languages containing
+                 * non-ASCII characters, like Chinese, Russian, Japanese etc.
+                 *
+                 * As described in the [jsPDF
+                 * docs](https://github.com/parallax/jsPDF#use-of-unicode-characters--utf-8),
+                 * the 14 standard fonts in PDF are limited to the ASCII-codepage.
+                 * Therefore, in order to support other text in the exported PDF, one or
+                 * more TTF font files have to be passed on to the exporting module.
+                 *
+                 * See more in [the
+                 * docs](https://www.highcharts.com/docs/export-module/client-side-export).
+                 *
+                 * @sample {highcharts} highcharts/exporting/offline-download-pdffont/
+                 *         Download PDF in a language containing non-Latin characters.
+                 *
+                 * @since 10.0.0
+                 * @requires modules/offline-exporting
+                 */
+                pdfFont: {
+                    /**
+                     * The TTF font file for normal `font-style`. If font variations like
+                     * `bold` or `italic` are not defined, the `normal` font will be used
+                     * for those too.
+                     *
+                     * @type string|undefined
+                     */
+                    normal: void 0,
+                    /**
+                     * The TTF font file for bold text.
+                     *
+                     * @type string|undefined
+                     */
+                    bold: void 0,
+                    /**
+                     * The TTF font file for bold and italic text.
+                     *
+                     * @type string|undefined
+                     */
+                    bolditalic: void 0,
+                    /**
+                     * The TTF font file for italic text.
+                     *
+                     * @type string|undefined
+                     */
+                    italic: void 0
+                },
                 /**
                  * When printing the chart from the menu item in the burger menu, if
                  * the on-screen chart exceeds this width, it is resized. After printing
@@ -1023,7 +1148,7 @@
                      * @type  {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
                      * @since 2.0
                      */
-                    symbolFill: "#666666" /* neutralColor60 */,
+                    symbolFill: "#666666" /* Palette.neutralColor60 */,
                     /**
                      * The color of the symbol's stroke or line.
                      *
@@ -1033,7 +1158,7 @@
                      * @type  {Highcharts.ColorString}
                      * @since 2.0
                      */
-                    symbolStroke: "#666666" /* neutralColor60 */,
+                    symbolStroke: "#666666" /* Palette.neutralColor60 */,
                     /**
                      * The pixel stroke width of the symbol on the button.
                      *
@@ -1094,9 +1219,9 @@
                  */
                 menuStyle: {
                     /** @ignore-option */
-                    border: "1px solid " + "#999999" /* neutralColor40 */,
+                    border: "1px solid ".concat("#999999" /* Palette.neutralColor40 */),
                     /** @ignore-option */
-                    background: "#ffffff" /* backgroundColor */,
+                    background: "#ffffff" /* Palette.backgroundColor */,
                     /** @ignore-option */
                     padding: '5px 0'
                 },
@@ -1122,7 +1247,7 @@
                     /** @ignore-option */
                     padding: '0.5em 1em',
                     /** @ignore-option */
-                    color: "#333333" /* neutralColor80 */,
+                    color: "#333333" /* Palette.neutralColor80 */,
                     /** @ignore-option */
                     background: 'none',
                     /** @ignore-option */
@@ -1149,9 +1274,9 @@
                  */
                 menuItemHoverStyle: {
                     /** @ignore-option */
-                    background: "#335cad" /* highlightColor80 */,
+                    background: "#335cad" /* Palette.highlightColor80 */,
                     /** @ignore-option */
-                    color: "#ffffff" /* backgroundColor */
+                    color: "#ffffff" /* Palette.backgroundColor */
                 }
             };
         /* *
@@ -1269,29 +1394,24 @@
             discardElement = U.discardElement,
             merge = U.merge,
             objectEach = U.objectEach;
+        /* *
+         *
+         *  Functions
+         *
+         * */
         /**
          * Perform an Ajax call.
          *
          * @function Highcharts.ajax
          *
-         * @param {Partial<Highcharts.AjaxSettingsObject>} attr
+         * @param {Highcharts.AjaxSettingsObject} settings
          *        The Ajax settings to use.
          *
          * @return {false|undefined}
          *         Returns false, if error occured.
          */
-        function ajax(attr) {
-            var options = merge(true, {
-                    url: false,
-                    type: 'get',
-                    dataType: 'json',
-                    success: false,
-                    error: false,
-                    data: false,
-                    headers: {}
-                },
-                attr),
-                headers = {
+        function ajax(settings) {
+            var headers = {
                     json: 'application/json',
                     xml: 'application/xml',
                     text: 'text/plain',
@@ -1299,6 +1419,7 @@
                 },
                 r = new XMLHttpRequest();
             /**
+             * Private error handler.
              * @private
              * @param {XMLHttpRequest} xhr
              * Internal request object.
@@ -1306,49 +1427,53 @@
              * Occured error.
              */
             function handleError(xhr, err) {
-                if (options.error) {
-                    options.error(xhr, err);
+                if (settings.error) {
+                    settings.error(xhr, err);
                 }
                 else {
                     // @todo Maybe emit a highcharts error event here
                 }
             }
-            if (!options.url) {
+            if (!settings.url) {
                 return false;
             }
-            r.open(options.type.toUpperCase(), options.url, true);
-            if (!options.headers['Content-Type']) {
-                r.setRequestHeader('Content-Type', headers[options.dataType] || headers.text);
+            r.open((settings.type || 'get').toUpperCase(), settings.url, true);
+            if (!settings.headers || !settings.headers['Content-Type']) {
+                r.setRequestHeader('Content-Type', headers[settings.dataType || 'json'] || headers.text);
             }
-            objectEach(options.headers, function (val, key) {
+            objectEach(settings.headers, function (val, key) {
                 r.setRequestHeader(key, val);
             });
+            if (settings.responseType) {
+                r.responseType = settings.responseType;
+            }
             // @todo lacking timeout handling
             r.onreadystatechange = function () {
                 var res;
                 if (r.readyState === 4) {
                     if (r.status === 200) {
-                        res = r.responseText;
-                        if (options.dataType === 'json') {
-                            try {
-                                res = JSON.parse(res);
-                            }
-                            catch (e) {
-                                return handleError(r, e);
+                        if (settings.responseType !== 'blob') {
+                            res = r.responseText;
+                            if (settings.dataType === 'json') {
+                                try {
+                                    res = JSON.parse(res);
+                                }
+                                catch (e) {
+                                    if (e instanceof Error) {
+                                        return handleError(r, e);
+                                    }
+                                }
                             }
                         }
-                        return options.success && options.success(res);
+                        return settings.success && settings.success(res, r);
                     }
                     handleError(r, r.responseText);
                 }
             };
-            try {
-                options.data = JSON.stringify(options.data);
+            if (settings.data && typeof settings.data !== 'string') {
+                settings.data = JSON.stringify(settings.data);
             }
-            catch (e) {
-                // empty
-            }
-            r.send(options.data || true);
+            r.send(settings.data);
         }
         /**
          * Get a JSON resource over XHR, also supporting CORS without preflight.
@@ -1405,7 +1530,7 @@
                     type: 'hidden',
                     name: name,
                     value: val
-                }, null, form);
+                }, void 0, form);
             });
             // submit
             form.submit();
@@ -1422,33 +1547,38 @@
                 getJSON: getJSON,
                 post: post
             };
+        /* *
+         *
+         *  API Declarations
+         *
+         * */
         /**
          * @interface Highcharts.AjaxSettingsObject
          */ /**
         * The payload to send.
         *
         * @name Highcharts.AjaxSettingsObject#data
-        * @type {string|Highcharts.Dictionary<any>}
+        * @type {string|Highcharts.Dictionary<any>|undefined}
         */ /**
         * The data type expected.
         * @name Highcharts.AjaxSettingsObject#dataType
-        * @type {"json"|"xml"|"text"|"octet"}
+        * @type {"json"|"xml"|"text"|"octet"|undefined}
         */ /**
         * Function to call on error.
         * @name Highcharts.AjaxSettingsObject#error
-        * @type {Function}
+        * @type {Function|undefined}
         */ /**
         * The headers; keyed on header name.
         * @name Highcharts.AjaxSettingsObject#headers
-        * @type {Highcharts.Dictionary<string>}
+        * @type {Highcharts.Dictionary<string>|undefined}
         */ /**
         * Function to call on success.
         * @name Highcharts.AjaxSettingsObject#success
-        * @type {Function}
+        * @type {Function|undefined}
         */ /**
         * The HTTP method to use. For example GET or POST.
         * @name Highcharts.AjaxSettingsObject#type
-        * @type {string}
+        * @type {string|undefined}
         */ /**
         * The URL to call.
         * @name Highcharts.AjaxSettingsObject#url
@@ -1472,6 +1602,7 @@
          * */
         var defaultOptions = D.defaultOptions;
         var doc = G.doc,
+            SVG_NS = G.SVG_NS,
             win = G.win;
         var addEvent = U.addEvent,
             css = U.css,
@@ -1573,16 +1704,12 @@
                 if (btnOptions.enabled === false || !btnOptions.theme) {
                     return;
                 }
-                var attr = btnOptions.theme,
-                    states = attr.states,
-                    hover = states && states.hover,
-                    select = states && states.select;
+                var attr = btnOptions.theme;
                 var callback;
                 if (!chart.styledMode) {
-                    attr.fill = pick(attr.fill, "#ffffff" /* backgroundColor */);
+                    attr.fill = pick(attr.fill, "#ffffff" /* Palette.backgroundColor */);
                     attr.stroke = pick(attr.stroke, 'none');
                 }
-                delete attr.states;
                 if (onclick) {
                     callback = function (e) {
                         if (e) {
@@ -1613,15 +1740,13 @@
                 }
                 if (!chart.styledMode) {
                     attr['stroke-linecap'] = 'round';
-                    attr.fill = pick(attr.fill, "#ffffff" /* backgroundColor */);
+                    attr.fill = pick(attr.fill, "#ffffff" /* Palette.backgroundColor */);
                     attr.stroke = pick(attr.stroke, 'none');
                 }
                 var button = renderer
                         .button(btnOptions.text, 0, 0,
                     callback,
-                    attr,
-                    hover,
-                    select)
+                    attr)
                         .addClass(options.className)
                         .attr({
                         title: pick(chart.options.lang[btnOptions._titleKey || btnOptions.titleKey], '')
@@ -1953,7 +2078,7 @@
                                     };
                                     css(element, extend({
                                         cursor: 'pointer'
-                                    }, navOptions.menuItemStyle));
+                                    }, navOptions.menuItemStyle || {}));
                                 }
                             }
                             // Keep references to menu divs to be able to destroy them
@@ -2329,10 +2454,10 @@
                     visibility: 'hidden'
                 });
                 doc.body.appendChild(iframe);
-                var iframeDoc = iframe.contentWindow.document;
-                iframeDoc.open();
-                iframeDoc.write('<svg xmlns="http://www.w3.org/2000/svg"></svg>');
-                iframeDoc.close();
+                var iframeDoc = (iframe.contentWindow && iframe.contentWindow.document);
+                if (iframeDoc) {
+                    iframeDoc.body.appendChild(iframeDoc.createElementNS(SVG_NS, 'svg'));
+                }
                 /**
                  * Call this on all elements and recurse to children
                  * @private
@@ -2340,9 +2465,10 @@
                  *        Element child
                      */
                 function recurse(node) {
+                    var filteredStyles = {};
                     var styles,
-                        parentStyles,
-                        cssText = '',
+                        parentStyles, 
+                        // cssText = '',
                         dummy,
                         styleAttr,
                         blacklisted,
@@ -2393,13 +2519,14 @@
                                     }
                                     // Styles
                                 }
-                                else {
-                                    cssText += hyphenate(prop) + ':' + val + ';';
+                                else if (prop !== 'parentRule') {
+                                    filteredStyles[prop] = val;
                                 }
                             }
                         }
                     }
-                    if (node.nodeType === 1 &&
+                    if (iframeDoc &&
+                        node.nodeType === 1 &&
                         unstyledElements.indexOf(node.nodeName) === -1) {
                         styles = win.getComputedStyle(node, null);
                         parentStyles = node.nodeName === 'svg' ?
@@ -2428,20 +2555,28 @@
                             dummySVG.removeChild(dummy);
                         }
                         // Loop through all styles and add them inline if they are ok
-                        if (G.isFirefox || G.isMS) {
-                            // Some browsers put lots of styles on the prototype
-                            for (var p in styles) { // eslint-disable-line guard-for-in
+                        for (var p in styles) {
+                            if (
+                            // Some browsers put lots of styles on the prototype...
+                            G.isFirefox ||
+                                G.isMS ||
+                                G.isSafari || // #16902
+                                // ... Chrome puts them on the instance
+                                Object.hasOwnProperty.call(styles, p)) {
                                 filterStyles(styles[p], p);
                             }
                         }
-                        else {
-                            objectEach(styles, filterStyles);
-                        }
                         // Apply styles
+                        /*
                         if (cssText) {
                             styleAttr = node.getAttribute('style');
-                            node.setAttribute('style', (styleAttr ? styleAttr + ';' : '') + cssText);
+                            node.setAttribute(
+                                'style',
+                                (styleAttr ? styleAttr + ';' : '') + cssText
+                            );
                         }
+                        */
+                        css(node, filteredStyles);
                         // Set default stroke width (needed at least for IE)
                         if (node.nodeName === 'svg') {
                             node.setAttribute('stroke-width', '1px');
@@ -2456,7 +2591,7 @@
                 /**
                  * Remove the dummy objects used to get defaults
                  * @private
-                     */
+                 */
                 function tearDown() {
                     dummySVG.parentNode.removeChild(dummySVG);
                     // Remove trash from DOM that stayed after each exporting