highcharts 13.0.2 → 13.1.0

package/esm/modules/accessibility.src.js

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: LicenseRef-Highcharts
 /**
- * @license Highcharts JS v13.0.2 (2026-08-27)
+ * @license Highcharts JS v13.1.0 (2026-09-18)
  * @module highcharts/modules/accessibility
  * @requires highcharts
  *
@@ -18,48 +18,27 @@ import * as __WEBPACK_EXTERNAL_MODULE__highcharts_src_js_8202131d__ from "../hig
 /******/ 
 /************************************************************************/
 /******/ /* webpack/runtime/compat get default export */
-/******/ (() => {
-/******/ 	// getDefaultExport function for compatibility with non-harmony modules
-/******/ 	__webpack_require__.n = (module) => {
-/******/ 		const getter = module && module.__esModule ?
-/******/ 			() => (module['default']) :
-/******/ 			() => (module);
-/******/ 		__webpack_require__.d(getter, { a: getter });
-/******/ 		return getter;
-/******/ 	};
-/******/ })();
+/******/ // getDefaultExport function for compatibility with non-harmony modules
+/******/ __webpack_require__.n = (module) => {
+/******/ 	const getter = module && module.__esModule ?
+/******/ 		() => (module['default']) :
+/******/ 		() => (module);
+/******/ 	__webpack_require__.d(getter, { a: getter });
+/******/ 	return getter;
+/******/ };
 /******/ 
 /******/ /* webpack/runtime/define property getters */
-/******/ (() => {
-/******/ 	// define getter/value functions for harmony exports
-/******/ 	__webpack_require__.d = (exports, definition) => {
-/******/ 		if(Array.isArray(definition)) {
-/******/ 			var i = 0;
-/******/ 			while(i < definition.length) {
-/******/ 				var key = definition[i++];
-/******/ 				var binding = definition[i++];
-/******/ 				if(!__webpack_require__.o(exports, key)) {
-/******/ 					if(binding === 0) {
-/******/ 						Object.defineProperty(exports, key, { enumerable: true, value: definition[i++] });
-/******/ 					} else {
-/******/ 						Object.defineProperty(exports, key, { enumerable: true, get: binding });
-/******/ 					}
-/******/ 				} else if(binding === 0) { i++; }
-/******/ 			}
-/******/ 		} else {
-/******/ 			for(var key in definition) {
-/******/ 				if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {
-/******/ 					Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });
-/******/ 				}
-/******/ 			}
+/******/ // define getter/value functions for harmony exports
+/******/ __webpack_require__.d = (exports, definition) => {
+/******/ 	for(var key in definition) {
+/******/ 		if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {
+/******/ 			Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });
 /******/ 		}
-/******/ 	};
-/******/ })();
+/******/ 	}
+/******/ };
 /******/ 
 /******/ /* webpack/runtime/hasOwnProperty shorthand */
-/******/ (() => {
-/******/ 	__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))
-/******/ })();
+/******/ __webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop));
 /******/ 
 /************************************************************************/
 
@@ -201,11 +180,20 @@ function escapeStringForHTML(str) {
         .replace(/\//g, '&#x2F;');
 }
 /**
- * Get an element by ID
+ * Get the shadow root the element lives in, if any. Lookups in the main
+ * document do not cross a shadow boundary. (#22682)
  * @private
  */
-function getElement(id) {
-    return doc.getElementById(id);
+function getShadowRoot(el) {
+    const root = el?.getRootNode();
+    return root?.host ? root : void 0;
+}
+/**
+ * Get an element by ID, from the reference element's shadow root if it has one.
+ * @private
+ */
+function getElement(id, referenceElement) {
+    return (getShadowRoot(referenceElement) || doc).getElementById(id);
 }
 /**
  * Get a fake mouse event of a given type. If relatedTarget is not given,
@@ -351,7 +339,7 @@ function stripHTMLTagsFromString(str, isForExport = false) {
  * @private
  */
 function visuallyHideElement(element) {
-    (0,external_highcharts_src_js_default_namespaceObject.css)(element, {
+    ;(0,external_highcharts_src_js_default_namespaceObject.css)(element, {
         position: 'absolute',
         width: '1px',
         height: '1px',
@@ -377,6 +365,7 @@ const HTMLUtilities = {
     getElement,
     getFakeMouseEvent,
     getHeadingTagNameForElement,
+    getShadowRoot,
     removeChildNodes,
     removeClass,
     removeElement,
@@ -2147,7 +2136,7 @@ const { format: InfoRegionsComponent_format } = (external_highcharts_src_js_defa
 
 const { doc: InfoRegionsComponent_doc } = (external_highcharts_src_js_default_default());
 
-const { addClass: InfoRegionsComponent_addClass, getElement: InfoRegionsComponent_getElement, getHeadingTagNameForElement: InfoRegionsComponent_getHeadingTagNameForElement, stripHTMLTagsFromString: InfoRegionsComponent_stripHTMLTagsFromString, visuallyHideElement: InfoRegionsComponent_visuallyHideElement } = Utils_HTMLUtilities;
+const { addClass: InfoRegionsComponent_addClass, getElement: InfoRegionsComponent_getElement, getHeadingTagNameForElement: InfoRegionsComponent_getHeadingTagNameForElement, getShadowRoot: InfoRegionsComponent_getShadowRoot, stripHTMLTagsFromString: InfoRegionsComponent_stripHTMLTagsFromString, visuallyHideElement: InfoRegionsComponent_visuallyHideElement } = Utils_HTMLUtilities;
 
 /* *
  *
@@ -2362,7 +2351,11 @@ class InfoRegionsComponent extends Accessibility_AccessibilityComponent {
         if (typeof linkedDescOption !== 'string') {
             return linkedDescOption;
         }
-        const query = InfoRegionsComponent_format(linkedDescOption, this.chart), queryMatch = InfoRegionsComponent_doc.querySelectorAll(query);
+        const query = InfoRegionsComponent_format(linkedDescOption, this.chart), shadowRoot = InfoRegionsComponent_getShadowRoot(this.chart.renderTo), shadowMatch = shadowRoot?.querySelectorAll(query), 
+        // The description may also live outside the shadow root (#22682)
+        queryMatch = shadowMatch?.length ?
+            shadowMatch :
+            InfoRegionsComponent_doc.querySelectorAll(query);
         if (queryMatch.length === 1) {
             return queryMatch[0];
         }
@@ -2534,7 +2527,7 @@ class InfoRegionsComponent extends Accessibility_AccessibilityComponent {
      * @private
      */
     getEndOfChartMarkerText() {
-        const endMarkerId = `highcharts-end-of-chart-marker-${this.chart.index}`, endMarker = InfoRegionsComponent_getElement(endMarkerId);
+        const endMarkerId = `highcharts-end-of-chart-marker-${this.chart.index}`, endMarker = InfoRegionsComponent_getElement(endMarkerId, this.chart.renderTo);
         if (endMarker) {
             return endMarker.outerHTML;
         }
@@ -2571,8 +2564,8 @@ class InfoRegionsComponent extends Accessibility_AccessibilityComponent {
      * @param {string} sonifyButtonId
      */
     initSonifyButton(sonifyButtonId) {
-        const el = this.sonifyButton = InfoRegionsComponent_getElement(sonifyButtonId);
         const chart = this.chart;
+        const el = this.sonifyButton = InfoRegionsComponent_getElement(sonifyButtonId, chart.renderTo);
         const defaultHandler = (e) => {
             if (el) {
                 el.setAttribute('aria-hidden', 'true');
@@ -2608,11 +2601,11 @@ class InfoRegionsComponent extends Accessibility_AccessibilityComponent {
      * @param {string} tableButtonId
      */
     initDataTableButton(tableButtonId) {
-        const el = this.viewDataTableButton = InfoRegionsComponent_getElement(tableButtonId), chart = this.chart, tableId = tableButtonId.replace('hc-linkto-', '');
+        const chart = this.chart, el = this.viewDataTableButton = InfoRegionsComponent_getElement(tableButtonId, chart.renderTo), tableId = tableButtonId.replace('hc-linkto-', '');
         if (el) {
             (0,external_highcharts_src_js_default_namespaceObject.attr)(el, {
                 tabindex: -1,
-                'aria-expanded': !!InfoRegionsComponent_getElement(tableId)
+                'aria-expanded': !!InfoRegionsComponent_getElement(tableId, chart.renderTo)
             });
             el.onclick = chart.options.accessibility
                 .screenReaderSection.onViewDataTableClick ||
@@ -3223,7 +3216,7 @@ class KeyboardNavigation {
      * @private
      */
     updateExitAnchor() {
-        const endMarkerId = `highcharts-end-of-chart-marker-${this.chart.index}`, endMarker = KeyboardNavigation_getElement(endMarkerId);
+        const endMarkerId = `highcharts-end-of-chart-marker-${this.chart.index}`, endMarker = KeyboardNavigation_getElement(endMarkerId, this.chart.renderTo);
         this.removeExitAnchor();
         if (endMarker) {
             this.makeElementAnExitAnchor(endMarker);
@@ -4084,7 +4077,8 @@ function compose(ChartClass, NavigatorClass) {
         const chartProto = ChartClass.prototype;
         NavigatorConstructor = NavigatorClass;
         chartProto.callbacks.push(onChartCallback);
-        (0,external_highcharts_src_js_default_namespaceObject.addEvent)(ChartClass, 'afterAddSeries', onChartAfterAddSeries);
+        (0,external_highcharts_src_js_default_namespaceObject.addEvent)(ChartClass, 'afterAddSeries', resetBaseSeries);
+        (0,external_highcharts_src_js_default_namespaceObject.addEvent)(ChartClass, 'afterDrillUp', resetBaseSeries);
         (0,external_highcharts_src_js_default_namespaceObject.addEvent)(ChartClass, 'afterSetChartSize', onChartAfterSetChartSize);
         (0,external_highcharts_src_js_default_namespaceObject.addEvent)(ChartClass, 'afterUpdate', onChartAfterUpdate);
         (0,external_highcharts_src_js_default_namespaceObject.addEvent)(ChartClass, 'beforeRender', onChartBeforeRender);
@@ -4093,13 +4087,12 @@ function compose(ChartClass, NavigatorClass) {
     }
 }
 /**
- * Handle adding new series.
+ * Reset the base series.
  * @internal
  */
-function onChartAfterAddSeries() {
+function resetBaseSeries() {
     if (this.navigator) {
-        // Recompute which series should be shown in navigator, and add them
-        this.navigator.setBaseSeries(null, false);
+        this.navigator.setBaseSeries(void 0, false);
     }
 }
 /**
@@ -4248,7 +4241,7 @@ const ChartNavigatorComposition = {
  * */
 
 
-const { isTouchDevice: NavigatorAxisComposition_isTouchDevice } = (external_highcharts_src_js_default_default());
+const { composed, isTouchDevice: NavigatorAxisComposition_isTouchDevice } = (external_highcharts_src_js_default_default());
 
 /* *
  *
@@ -4314,8 +4307,7 @@ class NavigatorAxisAdditions {
      *
      * */
     static compose(AxisClass) {
-        if (!AxisClass.keepProps.includes('navigatorAxis')) {
-            AxisClass.keepProps.push('navigatorAxis');
+        if ((0,external_highcharts_src_js_default_namespaceObject.pushUnique)(composed, 'Axis.Navigator')) {
             (0,external_highcharts_src_js_default_namespaceObject.addEvent)(AxisClass, 'init', onAxisInit);
             (0,external_highcharts_src_js_default_namespaceObject.addEvent)(AxisClass, 'setExtremes', onAxisSetExtremes);
         }
@@ -5426,7 +5418,7 @@ function Symbols_arc(cx, cy, w, h, options) {
  * Path
  */
 function callout(x, y, w, h, options) {
-    const arrowLength = 6, halfDistance = 6, r = Math.min((options?.r) || 0, w, h), safeDistance = r + halfDistance, anchorX = options?.anchorX, anchorY = options?.anchorY || 0;
+    const arrowLength = options?.arrowLength ?? 6, halfDistance = 6, r = Math.min((options?.r) || 0, w, h), safeDistance = r + halfDistance, anchorX = options?.anchorX, anchorY = options?.anchorY || 0;
     const path = Symbols_roundedRect(x, y, w, h, { r });
     if (!(0,external_highcharts_src_js_default_namespaceObject.isNumber)(anchorX)) {
         return path;
@@ -5953,7 +5945,7 @@ const StockUtilities = {
 
 const { defaultOptions: NavigatorComposition_defaultOptions } = (external_highcharts_src_js_default_default());
 
-const { composed } = (external_highcharts_src_js_default_default());
+const { composed: NavigatorComposition_composed } = (external_highcharts_src_js_default_default());
 
 
 
@@ -5974,7 +5966,7 @@ const { setFixedRange: NavigatorComposition_setFixedRange } = Utilities_StockUti
 /** @internal */
 function NavigatorComposition_compose(ChartClass, AxisClass, SeriesClass) {
     NavigatorAxisComposition.compose(AxisClass);
-    if ((0,external_highcharts_src_js_default_namespaceObject.pushUnique)(composed, 'Navigator')) {
+    if ((0,external_highcharts_src_js_default_namespaceObject.pushUnique)(NavigatorComposition_composed, 'Navigator')) {
         ChartClass.prototype.setFixedRange = NavigatorComposition_setFixedRange;
         (0,external_highcharts_src_js_default_namespaceObject.extend)((external_highcharts_src_js_default_SVGRenderer_default()).prototype.symbols, Navigator_NavigatorSymbols);
         (0,external_highcharts_src_js_default_namespaceObject.extend)(NavigatorComposition_defaultOptions, { navigator: Navigator_NavigatorDefaults });
@@ -6126,6 +6118,9 @@ var ScrollbarAxis;
                 }
             });
         }
+        else if (axis.scrollbar) {
+            axis.scrollbar = axis.scrollbar.destroy();
+        }
     }
     /**
      * Wrap rendering axis, and update scrollbar if one is created.
@@ -6263,14 +6258,12 @@ var ScrollbarAxis;
  */
 const ScrollbarDefaults = {
     /**
-     * The height of the scrollbar. If `buttonsEnabled` is true , the height
+     * The height of the scrollbar. If `buttonsEnabled` is true, the height
      * also applies to the width of the scroll arrows so that they are always
      * squares.
      *
      * @sample stock/scrollbar/style/
      *         Non-default height
-     *
-     * @type    {number}
      */
     height: 10,
     /**
@@ -7058,7 +7051,7 @@ class Scrollbar {
             // On the bottom or the right side of the track:
             scroller.updatePosition(scroller.from - range, scroller.to - range);
         }
-        (0,external_highcharts_src_js_default_namespaceObject.fireEvent)(scroller, 'changed', {
+        ;(0,external_highcharts_src_js_default_namespaceObject.fireEvent)(scroller, 'changed', {
             from: scroller.from,
             to: scroller.to,
             trigger: 'scrollbar',
@@ -8577,11 +8570,7 @@ class Navigator {
             (0,external_highcharts_src_js_default_namespaceObject.erase)(this.chart.axes, this.yAxis);
         }
         // Destroy series
-        (this.series || []).forEach((s) => {
-            if (s.destroy) {
-                s.destroy();
-            }
-        });
+        ;(0,external_highcharts_src_js_default_namespaceObject.destroyObjectProperties)(this.series || []);
         // Destroy properties
         [
             'series', 'xAxis', 'yAxis', 'shades', 'outline', 'scrollbarTrack',
@@ -8870,6 +8859,8 @@ const { getAxisDescription: SeriesDescriber_getAxisDescription, getSeriesFirstPo
 
 const { format: SeriesDescriber_format, numberFormat } = (external_highcharts_src_js_default_Templating_default());
 
+const { composed: SeriesDescriber_composed } = (external_highcharts_src_js_default_default());
+
 const { reverseChildNodes: SeriesDescriber_reverseChildNodes, stripHTMLTagsFromString: SeriesDescriber_stripHTMLTags } = Utils_HTMLUtilities;
 
 /* *
@@ -8877,6 +8868,27 @@ const { reverseChildNodes: SeriesDescriber_reverseChildNodes, stripHTMLTagsFromS
  *  Functions
  *
  * */
+/**
+ * @private
+ */
+function SeriesDescriber_compose(PointClass) {
+    if ((0,external_highcharts_src_js_default_namespaceObject.pushUnique)(SeriesDescriber_composed, 'A11y.SD')) {
+        (0,external_highcharts_src_js_default_namespaceObject.wrap)(PointClass.prototype, 'applyOptions', pointApplyOptions);
+    }
+}
+/**
+ * Discard the mock graphic once the point is no longer null, so that the
+ * series can draw a real marker for it, #25299.
+ * @private
+ */
+function pointApplyOptions(proceed, ...args) {
+    const point = proceed.apply(this, args);
+    if (point.hasMockGraphic && !point.isNull) {
+        point.graphic = point.graphic?.destroy();
+        delete point.hasMockGraphic;
+    }
+    return point;
+}
 /**
  * @private
  */
@@ -9262,6 +9274,7 @@ function describeSeries(series) {
  *
  * */
 const SeriesDescriber = {
+    compose: SeriesDescriber_compose,
     defaultPointDescriptionFormatter,
     defaultSeriesDescriptionFormatter,
     describeSeries
@@ -9741,7 +9754,7 @@ class ProxyElement {
      * Set visually hidden style on a proxy element
      */
     hideElementVisually(el) {
-        (0,external_highcharts_src_js_default_namespaceObject.css)(el, {
+        ;(0,external_highcharts_src_js_default_namespaceObject.css)(el, {
             borderWidth: 0,
             backgroundColor: 'transparent',
             cursor: 'pointer',
@@ -9926,7 +9939,7 @@ class ProxyProvider {
         if (!group) {
             throw new Error('ProxyProvider.updateGroupAttrs: Invalid group key ' + groupKey);
         }
-        (0,external_highcharts_src_js_default_namespaceObject.attr)(group.groupElement, attributes);
+        ;(0,external_highcharts_src_js_default_namespaceObject.attr)(group.groupElement, attributes);
     }
     /**
      * Reorder the proxy groups.
@@ -10257,7 +10270,7 @@ class RangeSelectorComponent extends Accessibility_AccessibilityComponent {
      * @private
      */
     setRangeButtonAttrs(button) {
-        (0,external_highcharts_src_js_default_namespaceObject.attr)(button.element, {
+        ;(0,external_highcharts_src_js_default_namespaceObject.attr)(button.element, {
             tabindex: -1,
             role: 'button'
         });
@@ -10786,7 +10799,7 @@ var ForcedMarkersComposition;
      * @private
      */
     function unforcePointMarkerOptions(pointOptions) {
-        (0,external_highcharts_src_js_default_namespaceObject.merge)(true, pointOptions.marker, {
+        ;(0,external_highcharts_src_js_default_namespaceObject.merge)(true, pointOptions.marker, {
             states: {
                 normal: {
                     opacity: getPointMarkerOpacity(pointOptions) || 1
@@ -11609,7 +11622,7 @@ const { hideSeriesFromAT: SeriesComponent_hideSeriesFromAT } = Utils_ChartUtilit
 
 
 
-const { describeSeries: SeriesComponent_describeSeries } = SeriesComponent_SeriesDescriber;
+const { compose: composeSeriesDescriber, describeSeries: SeriesComponent_describeSeries } = SeriesComponent_SeriesDescriber;
 
 /* *
  *
@@ -11635,6 +11648,7 @@ class SeriesComponent extends Accessibility_AccessibilityComponent {
     static compose(ChartClass, PointClass, SeriesClass) {
         SeriesComponent_NewDataAnnouncer.compose(SeriesClass);
         ForcedMarkers.compose(SeriesClass);
+        composeSeriesDescriber(PointClass);
         SeriesComponent_SeriesKeyboardNavigation.compose(ChartClass, PointClass, SeriesClass);
     }
     /* *
@@ -14257,7 +14271,7 @@ class Accessibility {
             a11yOptions.highContrastMode === true)) {
             HighContrastMode.setHighContrastTheme(chart);
         }
-        (0,external_highcharts_src_js_default_namespaceObject.fireEvent)(chart, 'afterA11yUpdate', {
+        ;(0,external_highcharts_src_js_default_namespaceObject.fireEvent)(chart, 'afterA11yUpdate', {
             accessibility: this
         });
     }
@@ -14404,7 +14418,7 @@ class Accessibility {
                     newOptions.customComponents;
                 delete newOptions.customComponents;
             }
-            (0,external_highcharts_src_js_default_namespaceObject.merge)(true, this.options.accessibility, newOptions);
+            ;(0,external_highcharts_src_js_default_namespaceObject.merge)(true, this.options.accessibility, newOptions);
             // Recreate from scratch
             if (this.accessibility && this.accessibility.destroy) {
                 this.accessibility.destroy();