highcharts 9.3.3 → 10.0.0

package/es-modules/Extensions/Data.js

@@ -19,6 +19,8 @@ import Point from '../Core/Series/Point.js';
 import SeriesRegistry from '../Core/Series/SeriesRegistry.js';
 var seriesTypes = SeriesRegistry.seriesTypes;
 import U from '../Core/Utilities.js';
+import D from '../Core/DefaultOptions.js';
+var getOptions = D.getOptions;
 var addEvent = U.addEvent, defined = U.defined, extend = U.extend, fireEvent = U.fireEvent, isNumber = U.isNumber, merge = U.merge, objectEach = U.objectEach, pick = U.pick, splat = U.splat;
 /**
  * Callback function to modify the CSV before parsing it by the data module.
@@ -609,6 +611,10 @@ var Data = /** @class */ (function () {
         this.firstRowAsNames = pick(options.firstRowAsNames, this.firstRowAsNames, true);
         this.decimalRegex = (decimalPoint &&
             new RegExp('^(-?[0-9]+)' + decimalPoint + '([0-9]+)$'));
+        // Always stop old polling when we have new options
+        if (this.liveDataTimeout !== void 0) {
+            clearTimeout(this.liveDataTimeout);
+        }
         // This is a two-dimensional array holding the raw, trimmed string
         // values with the same organisation as the columns array. It makes it
         // possible for example to revert from interpreted timestamps to
@@ -617,11 +623,7 @@ var Data = /** @class */ (function () {
         // No need to parse or interpret anything
         if (this.columns.length) {
             this.dataFound();
-            hasData = true;
-        }
-        if (this.hasURLOption(options)) {
-            clearTimeout(this.liveDataTimeout);
-            hasData = false;
+            hasData = !this.hasURLOption(options);
         }
         if (!hasData) {
             // Fetch live data
@@ -1357,7 +1359,7 @@ var Data = /** @class */ (function () {
                 success: function (json) {
                     fn(json);
                     if (options.enablePolling) {
-                        setTimeout(function () {
+                        data.liveDataTimeout = setTimeout(function () {
                             fetchSheet(fn);
                         }, refreshRate);
                     }
@@ -1451,9 +1453,10 @@ var Data = /** @class */ (function () {
      *        Column index
      */
     Data.prototype.parseColumn = function (column, col) {
-        var rawColumns = this.rawColumns, columns = this.columns, row = column.length, val, floatVal, trimVal, trimInsideVal, firstRowAsNames = this.firstRowAsNames, isXColumn = this.valueCount.xColumns.indexOf(col) !== -1, dateVal, backup = [], diff, chartOptions = this.chartOptions, descending, columnTypes = this.options.columnTypes || [], columnType = columnTypes[col], forceCategory = isXColumn && ((chartOptions &&
+        var rawColumns = this.rawColumns, columns = this.columns, firstRowAsNames = this.firstRowAsNames, isXColumn = this.valueCount.xColumns.indexOf(col) !== -1, backup = [], chartOptions = this.chartOptions, columnTypes = this.options.columnTypes || [], columnType = columnTypes[col], forceCategory = isXColumn && ((chartOptions &&
             chartOptions.xAxis &&
-            splat(chartOptions.xAxis)[0].type === 'category') || columnType === 'string');
+            splat(chartOptions.xAxis)[0].type === 'category') || columnType === 'string'), columnHasName = defined(column.name);
+        var row = column.length, val, floatVal, trimVal, trimInsideVal, dateVal, diff, descending;
         if (!rawColumns[col]) {
             rawColumns[col] = [];
         }
@@ -1468,7 +1471,8 @@ var Data = /** @class */ (function () {
             }
             // Disable number or date parsing by setting the X axis type to
             // category
-            if (forceCategory || (row === 0 && firstRowAsNames)) {
+            if (forceCategory ||
+                (row === 0 && firstRowAsNames && !columnHasName)) {
                 column[row] = '' + trimVal;
             }
             else if (+trimInsideVal === floatVal) { // is numeric
@@ -1815,7 +1819,7 @@ var Data = /** @class */ (function () {
      * @param {boolean} [redraw=true]
      */
     Data.prototype.update = function (options, redraw) {
-        var chart = this.chart;
+        var chart = this.chart, chartOptions = chart.options;
         if (options) {
             // Set the complete handler
             options.afterComplete = function (dataOptions) {
@@ -1834,8 +1838,13 @@ var Data = /** @class */ (function () {
                 }
             };
             // Apply it
-            merge(true, chart.options.data, options);
-            this.init(chart.options.data);
+            merge(true, chartOptions.data, options);
+            // Reset columns if fetching spreadsheet, to force a re-fetch
+            if (chartOptions.data && chartOptions.data.googleSpreadsheetKey &&
+                !options.columns) {
+                delete chartOptions.data.columns;
+            }
+            this.init(chartOptions.data);
         }
     };
     return Data;
@@ -1855,7 +1864,9 @@ G.data = function (dataOptions, chartOptions, chart) {
 addEvent(Chart, 'init', function (e) {
     var chart = this, // eslint-disable-line no-invalid-this
     userOptions = (e.args[0] || {}), callback = e.args[1];
-    if (userOptions && userOptions.data && !chart.hasDataDef) {
+    var defaultDataOptions = getOptions().data;
+    if ((defaultDataOptions || userOptions && userOptions.data) &&
+        !chart.hasDataDef) {
         chart.hasDataDef = true;
         /**
          * The data parser for this chart.
@@ -1863,7 +1874,8 @@ addEvent(Chart, 'init', function (e) {
          * @name Highcharts.Chart#data
          * @type {Highcharts.Data|undefined}
          */
-        chart.data = new G.Data(extend(userOptions.data, {
+        var dataOptions = merge(defaultDataOptions, userOptions.data);
+        chart.data = new G.Data(extend(dataOptions, {
             afterComplete: function (dataOptions) {
                 var i, series;
                 // Merge series configs

package/es-modules/Extensions/DataGrouping.js

@@ -735,8 +735,11 @@ Axis.prototype.setDataGrouping = function (dataGrouping, redraw) {
     }
     else {
         this.chart.options.series.forEach(function (seriesOptions) {
-            seriesOptions.dataGrouping = dataGrouping;
-        }, false);
+            // Merging dataGrouping options with already defined options #16759
+            seriesOptions.dataGrouping = typeof dataGrouping === 'boolean' ?
+                dataGrouping :
+                merge(dataGrouping, seriesOptions.dataGrouping);
+        });
     }
     // Clear ordinal slope, so we won't accidentaly use the old one (#7827)
     if (axis.ordinal) {

package/es-modules/Extensions/DraggablePoints.js

@@ -811,11 +811,11 @@ var defaultGuideBoxOptions = {
     }
 };
 /**
- * Options for the drag handles.
+ * Options for the drag handles available in column series.
  *
  * @declare      Highcharts.DragDropHandleOptionsObject
  * @since        6.2.0
- * @optionparent plotOptions.series.dragDrop.dragHandle
+ * @optionparent plotOptions.column.dragDrop.dragHandle
  *
  * @private
  */
@@ -827,7 +827,7 @@ var defaultDragHandleOptions = {
      *
      * @type      {Function}
      * @since     6.2.0
-     * @apioption plotOptions.series.dragDrop.dragHandle.pathFormatter
+     * @apioption plotOptions.column.dragDrop.dragHandle.pathFormatter
      */
     // pathFormatter: null,
     /**
@@ -837,7 +837,7 @@ var defaultDragHandleOptions = {
      *
      * @type      {string}
      * @since     6.2.0
-     * @apioption plotOptions.series.dragDrop.dragHandle.cursor
+     * @apioption plotOptions.column.dragDrop.dragHandle.cursor
      */
     // cursor: null,
     /**
@@ -1757,13 +1757,15 @@ Point.prototype.showDragHandles = function () {
             // Find position and path of handle
             pos = positioner(point);
             handleAttrs.d = path = pathFormatter(point);
-            if (!path || pos.x < 0 || pos.y < 0) {
+            // Correct left edge value depending on the xAxis' type, #16596
+            var minEdge = point.series.xAxis.categories ? -0.5 : 0;
+            if (!path || pos.x < minEdge || pos.y < 0) {
                 return;
             }
             // If cursor is not set explicitly, use axis direction
             handleAttrs.cursor = handleOptions.cursor ||
-                (val.axis === 'x') !== !!chart.inverted ?
-                'ew-resize' : 'ns-resize';
+                ((val.axis === 'x') !== !!chart.inverted ?
+                    'ew-resize' : 'ns-resize');
             // Create and add the handle element if it doesn't exist
             handle = chart.dragHandles[val.optionName];
             if (!handle) {

package/es-modules/Extensions/Drilldown.js

@@ -29,6 +29,7 @@ var seriesTypes = SeriesRegistry.seriesTypes;
 import SVGRenderer from '../Core/Renderer/SVG/SVGRenderer.js';
 import Tick from '../Core/Axis/Tick.js';
 import U from '../Core/Utilities.js';
+import Breadcrumbs from './Breadcrumbs.js';
 var addEvent = U.addEvent, removeEvent = U.removeEvent, extend = U.extend, fireEvent = U.fireEvent, merge = U.merge, objectEach = U.objectEach, pick = U.pick, syncTimeout = U.syncTimeout;
 /**
  * Gets fired when a drilldown point is clicked, before the new series is added.
@@ -151,18 +152,20 @@ extend(defaultOptions.lang,
  * @optionparent lang
  */
 {
-    /**
-     * The text for the button that appears when drilling down, linking back
-     * to the parent series. The parent series' name is inserted for
-     * `{series.name}`.
-     *
-     * @since    3.0.8
-     * @product  highcharts highmaps
-     * @requires modules/drilldown
-     *
-     * @private
-     */
-    drillUpText: '◁ Back to {series.name}'
+/**
+ * The text for the button that appears when drilling down, linking back
+ * to the parent series. The parent series' name is inserted for
+ * `{series.name}`.
+ *
+ * @since    3.0.8
+ * @product  highcharts highmaps
+ * @requires modules/drilldown
+ * @apioption lang.drillUpText
+ *
+ * @deprecated
+ *
+ * @private
+ */
 });
 /**
  * Options for drill down, the concept of inspecting increasingly high
@@ -194,6 +197,15 @@ defaultOptions.drilldown = {
      * @product   highcharts
      * @apioption drilldown.allowPointDrilldown
      */
+    /**
+     * Options for the breadcrumbs, the navigation at the top leading the way
+     * up through the drilldown levels.
+     *
+     * @since 10.0.0
+     * @product   highcharts
+     * @extends   navigation.breadcrumbs
+     * @optionparent drilldown.breadcrumbs
+     */
     /**
      * An array of series configurations for the drill down. Each series
      * configuration uses the same syntax as the [series](#series) option set.
@@ -280,17 +292,23 @@ defaultOptions.drilldown = {
         duration: 500
     },
     /**
+     *
      * Options for the drill up button that appears when drilling down on a
      * series. The text for the button is defined in
      * [lang.drillUpText](#lang.drillUpText).
      *
-     * @sample {highcharts} highcharts/drilldown/drillupbutton/
-     *         Drill up button
-     * @sample {highmaps} highcharts/drilldown/drillupbutton/
-     *         Drill up button
+     * This option is deprecated since 9.3.2, use `drilldown.breadcrumbs`
+     * instead.
+     *
+     * @sample highcharts/breadcrumbs/single-button
+     *         Breadcrumbs set up like a legacy button
+     * @sample {highcharts} highcharts/drilldown/drillupbutton/ Drill up button
+     * @sample {highmaps} highcharts/drilldown/drillupbutton/ Drill up button
      *
      * @since   3.0.8
      * @product highcharts highmaps
+     *
+     * @deprecated
      */
     drillUpButton: {
         /**
@@ -576,44 +594,50 @@ Chart.prototype.applyDrilldown = function () {
         delete this.resetZoomButton;
     }
     this.pointer.reset();
-    this.redraw();
-    this.showDrillUpButton();
     fireEvent(this, 'afterDrilldown');
+    this.redraw();
+    fireEvent(this, 'afterApplyDrilldown');
 };
-Chart.prototype.getDrilldownBackText = function () {
-    var drilldownLevels = this.drilldownLevels, lastLevel;
-    if (drilldownLevels && drilldownLevels.length > 0) { // #3352, async loading
-        lastLevel = drilldownLevels[drilldownLevels.length - 1];
-        lastLevel.series = lastLevel.seriesOptions;
-        return format(this.options.lang.drillUpText || '', lastLevel);
-    }
-};
-Chart.prototype.showDrillUpButton = function () {
-    var chart = this, backText = this.getDrilldownBackText(), buttonOptions = chart.options.drilldown.drillUpButton, attr, states, alignTo = (buttonOptions.relativeTo === 'chart' ||
-        buttonOptions.relativeTo === 'spacingBox' ?
-        null :
-        'scrollablePlotBox');
-    if (!this.drillUpButton) {
-        attr = buttonOptions.theme;
-        states = attr && attr.states;
-        this.drillUpButton = this.renderer
-            .button(backText, null, null, function () {
-            chart.drillUp();
-        }, attr, states && states.hover, states && states.select)
-            .addClass('highcharts-drillup-button')
-            .attr({
-            align: buttonOptions.position.align,
-            zIndex: 7
-        })
-            .add()
-            .align(buttonOptions.position, false, alignTo);
-    }
-    else {
-        this.drillUpButton.attr({
-            text: backText
-        })
-            .align();
+/**
+ * This method creates an array of arrays containing a level number
+ * with the corresponding series/point.
+ *
+ * @requires  modules/breadcrumbs
+ *
+ * @private
+ * @param {Highcharts.Chart} chart
+ *        Highcharts Chart object.
+ * @return {Array<Breadcrumbs.BreadcrumbOptions>}
+ *        List for Highcharts Breadcrumbs.
+ */
+var createBreadcrumbsList = function (chart) {
+    var list = [], drilldownLevels = chart.drilldownLevels;
+    // The list is based on drilldown levels from the chart object
+    if (drilldownLevels && drilldownLevels.length) {
+        // Add the initial series as the first element.
+        if (!list[0]) {
+            list.push({
+                level: 0,
+                levelOptions: drilldownLevels[0].seriesOptions
+            });
+        }
+        var lastBreadcrumb_1 = list[list.length - 1];
+        drilldownLevels.forEach(function (level) {
+            // If level is already added to breadcrumbs list,
+            // don't add it again- drilling categories
+            // + 1 because of the wrong levels numeration
+            // in drilldownLevels array.
+            if (level.levelNumber + 1 > lastBreadcrumb_1.level) {
+                list.push({
+                    level: level.levelNumber + 1,
+                    levelOptions: merge({
+                        name: level.lowerSeries.name
+                    }, level.pointOptions)
+                });
+            }
+        });
     }
+    return list;
 };
 /**
  * When the chart is drilled down to a child series, calling `chart.drillUp()`
@@ -630,6 +654,7 @@ Chart.prototype.drillUp = function () {
     if (!this.drilldownLevels || this.drilldownLevels.length === 0) {
         return;
     }
+    fireEvent(this, 'beforeDrillUp');
     var chart = this, drilldownLevels = chart.drilldownLevels, levelNumber = drilldownLevels[drilldownLevels.length - 1].levelNumber, i = drilldownLevels.length, chartSeries = chart.series, seriesI, level, oldSeries, newSeries, oldExtremes, addSeries = function (seriesOptions) {
         var addedSeries;
         chartSeries.forEach(function (series) {
@@ -646,6 +671,7 @@ Chart.prototype.drillUp = function () {
             newSeries = addedSeries;
         }
     };
+    var drilldownLevelsNumber = chart.drilldownLevels.length;
     while (i--) {
         level = drilldownLevels[i];
         if (level.levelNumber === levelNumber) {
@@ -665,12 +691,19 @@ Chart.prototype.drillUp = function () {
                 }
             }
             oldSeries.xData = []; // Overcome problems with minRange (#2898)
+            // Reset the names to start new series from the beginning.
+            // Do it once to preserve names when multiple
+            // series are added for the same axis, #16135.
+            if (oldSeries.xAxis &&
+                oldSeries.xAxis.names &&
+                (drilldownLevelsNumber === 0 || i === drilldownLevelsNumber)) {
+                oldSeries.xAxis.names.length = 0;
+            }
             level.levelSeriesOptions.forEach(addSeries);
             fireEvent(chart, 'drillup', {
                 seriesOptions: level.seriesPurgedOptions ||
                     level.seriesOptions
             });
-            this.resetZoomButton && this.resetZoomButton.destroy(); // #8095
             if (newSeries.type === oldSeries.type) {
                 newSeries.drilldownLevel = level;
                 newSeries.options.animation =
@@ -691,30 +724,46 @@ Chart.prototype.drillUp = function () {
             // it to the chart and show it.
             if (level.resetZoomButton) {
                 chart.resetZoomButton = level.resetZoomButton;
-                chart.resetZoomButton.show();
             }
         }
     }
+    fireEvent(chart, 'afterDrillUp');
     this.redraw();
-    if (this.drilldownLevels.length === 0) {
-        this.drillUpButton = this.drillUpButton.destroy();
-    }
-    else {
-        this.drillUpButton.attr({
-            text: this.getDrilldownBackText()
-        })
-            .align();
-    }
     this.ddDupes.length = []; // #3315
     // Fire a once-off event after all series have been drilled up (#5158)
     fireEvent(chart, 'drillupall');
 };
+/**
+ * A function to fade in a group. First, the element is being hidden,
+ * then, using `opactiy`, is faded in. Used for example by `dataLabelsGroup`
+ * where simple SVGElement.fadeIn() is not enough, because of other features
+ * (e.g. InactiveState) using `opacity` to fadeIn/fadeOut.
+ *
+ * @requires module:modules/drilldown
+ *
+ * @param {undefined|SVGElement} [group]
+ * The SVG element to be faded in.
+ */
+function fadeInGroup(group) {
+    var animationOptions = animObject(this.chart.options.drilldown.animation);
+    if (group) {
+        group.hide();
+        syncTimeout(function () {
+            // Make sure neither the group, or the chart, were destroyed
+            if (group && group.added) {
+                group.fadeIn();
+            }
+        }, Math.max(animationOptions.duration - 50, 0));
+    }
+}
 /* eslint-disable no-invalid-this */
 // Add update function to be called internally from Chart.update
 // (#7600, #12855)
 addEvent(Chart, 'afterInit', function () {
     var chart = this;
     chart.drilldown = {
+        chart: chart,
+        fadeInGroup: fadeInGroup,
         update: function (options, redraw) {
             merge(true, chart.options.drilldown, options);
             if (pick(redraw, true)) {
@@ -723,22 +772,6 @@ addEvent(Chart, 'afterInit', function () {
         }
     };
 });
-// Shift the drillUpButton to make the space for resetZoomButton, #8095.
-addEvent(Chart, 'afterShowResetZoom', function () {
-    var chart = this, bbox = chart.resetZoomButton && chart.resetZoomButton.getBBox(), buttonOptions = (chart.options.drilldown &&
-        chart.options.drilldown.drillUpButton);
-    if (this.drillUpButton &&
-        bbox &&
-        buttonOptions &&
-        buttonOptions.position &&
-        buttonOptions.position.x) {
-        this.drillUpButton.align({
-            x: buttonOptions.position.x - bbox.width - 10,
-            y: buttonOptions.position.y,
-            align: buttonOptions.position.align
-        }, false, buttonOptions.relativeTo || 'plotBox');
-    }
-});
 addEvent(Chart, 'render', function () {
     (this.xAxis || []).forEach(function (axis) {
         axis.ddPoints = {};
@@ -769,6 +802,31 @@ addEvent(Chart, 'render', function () {
         objectEach(axis.ticks, Tick.prototype.drillable);
     });
 });
+addEvent(H.Breadcrumbs, 'up', function (e) {
+    var chart = this.chart, drillUpsNumber = this.getLevel() - e.newLevel;
+    for (var i = 0; i < drillUpsNumber; i++) {
+        chart.drillUp();
+    }
+});
+addEvent(Chart, 'afterDrilldown', function () {
+    var chart = this, drilldownOptions = chart.options.drilldown, breadcrumbsOptions = drilldownOptions && drilldownOptions.breadcrumbs;
+    if (!chart.breadcrumbs) {
+        chart.breadcrumbs = new Breadcrumbs(chart, breadcrumbsOptions);
+    }
+    chart.breadcrumbs.updateProperties(createBreadcrumbsList(chart));
+});
+addEvent(Chart, 'afterDrillUp', function () {
+    var chart = this;
+    chart.breadcrumbs &&
+        chart.breadcrumbs.updateProperties(createBreadcrumbsList(chart));
+});
+addEvent(Chart, 'update', function (e) {
+    var breadcrumbs = this.breadcrumbs, breadcrumbOptions = e.options.drilldown &&
+        e.options.drilldown.breadcrumbs;
+    if (breadcrumbs && breadcrumbOptions) {
+        breadcrumbs.update(e.options.drilldown.breadcrumbs);
+    }
+});
 /**
  * When drilling up, keep the upper series invisible until the lower series has
  * moved into place.
@@ -854,10 +912,10 @@ ColumnSeries.prototype.animateDrilldown = function (init) {
                     .attr(animateFrom)
                     .animate(extend(point.shapeArgs, { fill: point.color || series.color }), animationOptions);
             }
-            if (point.dataLabel) {
-                point.dataLabel.fadeIn(animationOptions);
-            }
         });
+        if (chart.drilldown) {
+            chart.drilldown.fadeInGroup(this.dataLabelsGroup);
+        }
         // Reset to prototype
         delete this.animate;
     }
@@ -935,6 +993,9 @@ if (PieSeries) {
                             }))[animationOptions ? 'animate' : 'attr'](animateTo, animationOptions);
                         }
                     });
+                    if (this.chart.drilldown) {
+                        this.chart.drilldown.fadeInGroup(this.dataLabelsGroup);
+                    }
                     // Reset to prototype
                     delete this.animate;
                 }
@@ -1150,21 +1211,13 @@ addEvent(Point, 'afterSetState', function () {
         applyCursorCSS(this.series.halo, 'auto', false, styledMode);
     }
 });
-// After zooming out, shift the drillUpButton to the previous position, #8095.
-addEvent(Chart, 'selection', function (event) {
-    if (event.resetSelection === true && this.drillUpButton) {
-        var buttonOptions = (this.options.drilldown && this.options.drilldown.drillUpButton);
-        if (buttonOptions && buttonOptions.position) {
-            this.drillUpButton.align({
-                x: buttonOptions.position.x,
-                y: buttonOptions.position.y,
-                align: buttonOptions.position.align
-            }, false, buttonOptions.relativeTo || 'plotBox');
-        }
-    }
-});
 addEvent(Chart, 'drillup', function () {
     if (this.resetZoomButton) {
         this.resetZoomButton = this.resetZoomButton.destroy();
     }
 });
+addEvent(Chart, 'drillupall', function () {
+    if (this.resetZoomButton) {
+        this.showResetZoom();
+    }
+});

package/es-modules/Extensions/Exporting/Exporting.js

@@ -463,7 +463,7 @@ var Exporting;
                             };
                             css(element, extend({
                                 cursor: 'pointer'
-                            }, navOptions.menuItemStyle));
+                            }, navOptions.menuItemStyle || {}));
                         }
                     }
                     // Keep references to menu divs to be able to destroy them
@@ -917,15 +917,17 @@ var Exporting;
                     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');

package/es-modules/Extensions/Exporting/ExportingDefaults.js

@@ -132,7 +132,7 @@ var exporting = {
      * 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.
      *
@@ -196,6 +196,54 @@ var exporting = {
      * @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