@highcharts/grid-pro 2.2.0 → 2.3.1

package/es-modules/Accessibility/Accessibility.js

@@ -15,8 +15,6 @@ import D from '../Core/Defaults.js';
 const { defaultOptions } = D;
 import H from '../Core/Globals.js';
 const { doc } = H;
-import U from '../Core/Utilities.js';
-const { addEvent, extend, fireEvent, merge } = U;
 import HU from './Utils/HTMLUtilities.js';
 const { removeElement } = HU;
 import A11yI18n from './A11yI18n.js';
@@ -37,6 +35,7 @@ import highContrastTheme from './HighContrastTheme.js';
 import defaultOptionsA11Y from './Options/A11yDefaults.js';
 import defaultLangOptions from './Options/LangDefaults.js';
 import copyDeprecatedOptions from './Options/DeprecatedOptions.js';
+import { addEvent, extend, fireEvent, merge } from '../Shared/Utilities.js';
 /* *
  *
  *  Class

package/es-modules/Accessibility/AccessibilityComponent.d.ts

@@ -5,9 +5,9 @@ import type HTMLElement from '../Core/Renderer/HTML/HTMLElement';
 import type KeyboardNavigationHandler from './KeyboardNavigationHandler';
 import type SVGElement from '../Core/Renderer/SVG/SVGElement';
 import type ProxyProvider from './ProxyProvider';
+import type { EventOptions } from '../Shared/Utilities.js';
 import DOMElementProvider from './Utils/DOMElementProvider.js';
 import EventProvider from './Utils/EventProvider.js';
-import U from '../Core/Utilities.js';
 /**
  * The AccessibilityComponent base class, representing a part of the chart that
  * has accessibility logic connected to it. This class can be inherited from to
@@ -75,7 +75,7 @@ declare class AccessibilityComponent {
      * See EventProvider for details.
      * @private
      */
-    addEvent<T>(el: (T | Class<T>), type: string, fn: (Function | EventCallback<T>), options?: U.EventOptions): Function;
+    addEvent<T>(el: (T | Class<T>), type: string, fn: (Function | EventCallback<T>), options?: EventOptions): Function;
     /**
      * Create an element and keep track of it for later removal.
      * See DOMElementProvider for details.

package/es-modules/Accessibility/Components/ContainerComponent.js

@@ -32,7 +32,6 @@ class ContainerComponent extends AccessibilityComponent {
      *  Functions
      *
      * */
-    /* eslint-disable valid-jsdoc */
     /**
      * Called on first render/updates to the chart, including options changes.
      */

package/es-modules/Accessibility/Components/InfoRegionsComponent.js

@@ -25,14 +25,12 @@ import H from '../../Core/Globals.js';
 const { doc } = H;
 import HU from '../Utils/HTMLUtilities.js';
 const { addClass, getElement, getHeadingTagNameForElement, stripHTMLTagsFromString, visuallyHideElement } = HU;
-import U from '../../Core/Utilities.js';
-const { attr, pick, replaceNested } = U;
+import { attr, pick, replaceNested } from '../../Shared/Utilities.js';
 /* *
  *
  *  Functions
  *
  * */
-/* eslint-disable valid-jsdoc */
 /**
  * @private
  */
@@ -74,6 +72,7 @@ function buildTypeDescriptionFromSeries(chart, types, context) {
  *
  * @private
  * @function Highcharts.Chart#getTypeDescription
+ * @param {Highcharts.Chart} chart The associated Chart instance.
  * @param {Array<string>} types The series types in this chart.
  * @return {string} The text description of the chart type.
  */
@@ -130,7 +129,6 @@ class InfoRegionsComponent extends AccessibilityComponent {
      *  Functions
      *
      * */
-    /* eslint-disable valid-jsdoc */
     /**
      * Init the component
      * @private
@@ -179,8 +177,8 @@ class InfoRegionsComponent extends AccessibilityComponent {
                 buildContent: function (chart) {
                     const formatter = accessibilityOptions.screenReaderSection
                         .beforeChartFormatter;
-                    return formatter ? formatter(chart) :
-                        component.defaultBeforeChartFormatter(chart);
+                    return formatter ? formatter(chart, component) :
+                        component.defaultBeforeChartFormatter();
                 },
                 insertIntoDOM: function (el, chart) {
                     chart.renderTo.insertBefore(el, chart.renderTo.firstChild);
@@ -199,7 +197,7 @@ class InfoRegionsComponent extends AccessibilityComponent {
                 buildContent: function (chart) {
                     const formatter = accessibilityOptions.screenReaderSection
                         .afterChartFormatter;
-                    return formatter ? formatter(chart) :
+                    return formatter ? formatter(chart, component) :
                         component.defaultAfterChartFormatter();
                 },
                 insertIntoDOM: function (el, chart) {
@@ -477,7 +475,7 @@ class InfoRegionsComponent extends AccessibilityComponent {
                 const onPlayAsSoundClick = (chart.options.accessibility &&
                     chart.options.accessibility.screenReaderSection
                         .onPlayAsSoundClick);
-                (onPlayAsSoundClick || defaultHandler).call(this, e, chart);
+                (onPlayAsSoundClick || defaultHandler).call(this, e, chart, this);
             };
         }
     }

package/es-modules/Accessibility/Components/LegendComponent.js

@@ -16,13 +16,12 @@ const { animObject } = A;
 import H from '../../Core/Globals.js';
 const { doc } = H;
 import Legend from '../../Core/Legend/Legend.js';
-import U from '../../Core/Utilities.js';
-const { addEvent, fireEvent, isNumber, pick, syncTimeout } = U;
 import AccessibilityComponent from '../AccessibilityComponent.js';
 import KeyboardNavigationHandler from '../KeyboardNavigationHandler.js';
 import CU from '../Utils/ChartUtilities.js';
 const { getChartTitle } = CU;
 import HU from '../Utils/HTMLUtilities.js';
+import { addEvent, fireEvent, isNumber, pick, syncTimeout } from '../../Shared/Utilities.js';
 const { stripHTMLTagsFromString: stripHTMLTags, addClass, removeClass } = HU;
 /* *
  *

package/es-modules/Accessibility/Components/MenuComponent.js

@@ -11,13 +11,12 @@
  *
  * */
 'use strict';
-import U from '../../Core/Utilities.js';
-const { attr } = U;
 import AccessibilityComponent from '../AccessibilityComponent.js';
 import KeyboardNavigationHandler from '../KeyboardNavigationHandler.js';
 import ChartUtilities from '../Utils/ChartUtilities.js';
 const { getChartTitle, unhideChartElementFromAT } = ChartUtilities;
 import HTMLUtilities from '../Utils/HTMLUtilities.js';
+import { attr } from '../../Shared/Utilities.js';
 const { getFakeMouseEvent } = HTMLUtilities;
 /* *
  *
@@ -61,7 +60,6 @@ class MenuComponent extends AccessibilityComponent {
      *  Functions
      *
      * */
-    /* eslint-disable valid-jsdoc */
     /**
      * Init the component
      */

package/es-modules/Accessibility/Components/NavigatorComponent.js

@@ -24,12 +24,11 @@ import A from '../../Core/Animation/AnimationUtilities.js';
 const { animObject } = A;
 import T from '../../Core/Templating.js';
 const { format } = T;
-import U from '../../Core/Utilities.js';
-const { clamp, pick, syncTimeout } = U;
 import HU from '../Utils/HTMLUtilities.js';
 const { getFakeMouseEvent } = HU;
 import CU from '../Utils/ChartUtilities.js';
 const { getAxisRangeDescription, fireEventOnWrappedOrUnwrappedElement } = CU;
+import { clamp, internalClearTimeout, pick, syncTimeout } from '../../Shared/Utilities.js';
 /**
  * The NavigatorComponent class
  *
@@ -145,7 +144,7 @@ class NavigatorComponent extends AccessibilityComponent {
      */
     destroy() {
         if (this.updateNavigatorThrottleTimer) {
-            clearTimeout(this.updateNavigatorThrottleTimer);
+            internalClearTimeout(this.updateNavigatorThrottleTimer);
         }
         this.proxyProvider.removeGroup('navigator');
         if (this.announcer) {
@@ -222,7 +221,7 @@ class NavigatorComponent extends AccessibilityComponent {
         // Throttle updates so as not to reduce performance with
         // continuous keypress.
         if (this.updateNavigatorThrottleTimer) {
-            clearTimeout(this.updateNavigatorThrottleTimer);
+            internalClearTimeout(this.updateNavigatorThrottleTimer);
         }
         this.updateNavigatorThrottleTimer = setTimeout(performUpdate.bind(this, beforeAnnounce), 20);
     }

package/es-modules/Accessibility/Components/RangeSelectorComponent.js

@@ -16,8 +16,7 @@ import Announcer from '../Utils/Announcer.js';
 import ChartUtilities from '../Utils/ChartUtilities.js';
 const { unhideChartElementFromAT, getAxisRangeDescription } = ChartUtilities;
 import KeyboardNavigationHandler from '../KeyboardNavigationHandler.js';
-import U from '../../Core/Utilities.js';
-const { addEvent, attr } = U;
+import { addEvent, attr } from '../../Shared/Utilities.js';
 /* *
  *
  *  Functions
@@ -53,7 +52,6 @@ class RangeSelectorComponent extends AccessibilityComponent {
      *  Functions
      *
      * */
-    /* eslint-disable valid-jsdoc */
     /**
      * Init the component
      * @private

package/es-modules/Accessibility/Components/SeriesComponent/ForcedMarkers.js

@@ -13,8 +13,7 @@
 'use strict';
 import H from '../../../Core/Globals.js';
 const { composed } = H;
-import U from '../../../Core/Utilities.js';
-const { addEvent, merge, pushUnique } = U;
+import { addEvent, merge, pushUnique } from '../../../Shared/Utilities.js';
 /* *
  *
  *  Composition
@@ -149,7 +148,7 @@ var ForcedMarkersComposition;
     function seriesOnRender() {
         const series = this, options = series.options;
         if (shouldForceMarkers(series)) {
-            if (options.marker && options.marker.enabled === false) {
+            if (options.marker?.enabled === false) {
                 series.a11yMarkersForced = true;
                 forceZeroOpacityMarkerOptions(series.options);
             }
@@ -162,10 +161,17 @@ var ForcedMarkersComposition;
             // Mark series dirty to ensure marker graphics are cleaned up
             series.isDirty = true;
             unforceSeriesMarkerOptions(series);
-            if (options.marker && options.marker.enabled === false) { // #23329
+            if (options.marker?.enabled === false) { // #23329
                 delete series.resetA11yMarkerOptions; // #16624
             }
         }
+        else if (series.chart.styledMode &&
+            options.marker?.enabled === false &&
+            !hasIndividualPointMarkerOptions(series)) {
+            // `a11yMarkersForced` can be reset during `Series.update`.
+            // Clean up stale marker graphics that may still exist (#24164).
+            destroyPointMarkerGraphics(series);
+        }
     }
     /**
      * @private
@@ -189,6 +195,16 @@ var ForcedMarkersComposition;
             }
         });
     }
+    /**
+     * @private
+     */
+    function destroyPointMarkerGraphics(series) {
+        series.points?.forEach((point) => {
+            if (point.graphic) {
+                point.graphic = point.graphic.destroy();
+            }
+        });
+    }
     /**
      * Reset markers to normal
      * @private
@@ -201,13 +217,8 @@ var ForcedMarkersComposition;
                 resetMarkerOptions.states.normal.opacity;
             // Prevent ghost markers when zooming out (#23878).
             if (series.chart.styledMode &&
-                resetMarkerOptions.enabled === false &&
-                series.points) {
-                series.points.forEach((point) => {
-                    if (point.graphic) {
-                        point.graphic = point.graphic.destroy();
-                    }
-                });
+                resetMarkerOptions.enabled === false) {
+                destroyPointMarkerGraphics(series);
             }
             // Temporarily set the old marker options to enabled in order to
             // trigger destruction of the markers in Series.update.

package/es-modules/Accessibility/Components/SeriesComponent/NewDataAnnouncer.js

@@ -13,20 +13,18 @@
 'use strict';
 import H from '../../../Core/Globals.js';
 const { composed } = H;
-import U from '../../../Core/Utilities.js';
-const { addEvent, defined, pushUnique } = U;
 import Announcer from '../../Utils/Announcer.js';
 import ChartUtilities from '../../Utils/ChartUtilities.js';
 const { getChartTitle } = ChartUtilities;
 import EventProvider from '../../Utils/EventProvider.js';
 import SeriesDescriber from './SeriesDescriber.js';
+import { addEvent, defined, internalClearTimeout, pushUnique } from '../../../Shared/Utilities.js';
 const { defaultPointDescriptionFormatter, defaultSeriesDescriptionFormatter } = SeriesDescriber;
 /* *
  *
  *  Functions
  *
  * */
-/* eslint-disable valid-jsdoc */
 /**
  * @private
  */
@@ -80,7 +78,6 @@ class NewDataAnnouncer {
      *  Functions
      *
      * */
-    /* eslint-disable valid-jsdoc */
     /**
      * Initialize the new data announcer.
      * @private
@@ -184,7 +181,7 @@ class NewDataAnnouncer {
             if (message) {
                 // Is there already one queued?
                 if (this.queuedAnnouncement) {
-                    clearTimeout(this.queuedAnnouncementTimer);
+                    internalClearTimeout(this.queuedAnnouncementTimer);
                 }
                 // Build the announcement
                 this.queuedAnnouncement = {
@@ -221,7 +218,7 @@ class NewDataAnnouncer {
         const chart = this.chart, annOptions = chart.options.accessibility.announceNewData;
         // User supplied formatter?
         if (annOptions.announcementFormatter) {
-            const formatterRes = annOptions.announcementFormatter(dirtySeries, newSeries, newPoint);
+            const formatterRes = annOptions.announcementFormatter(dirtySeries, newSeries, newPoint, this);
             if (formatterRes !== false) {
                 return formatterRes.length ? formatterRes : null;
             }
@@ -289,7 +286,6 @@ class NewDataAnnouncer {
     /**
      * On new data in the series, make sure we add it to the dirty list.
      * @private
-     * @param {Highcharts.Series} series
      */
     function seriesOnUpdatedData() {
         const chart = this.chart, newDataAnnouncer = chart.accessibility?.components

package/es-modules/Accessibility/Components/SeriesComponent/SeriesComponent.js

@@ -37,7 +37,6 @@ class SeriesComponent extends AccessibilityComponent {
      *  Static Functions
      *
      * */
-    /* eslint-disable valid-jsdoc */
     /**
      * @private
      */

package/es-modules/Accessibility/Components/SeriesComponent/SeriesDescriber.js

@@ -3,7 +3,7 @@
  *  (c) 2009-2026 Highsoft AS
  *  Author: Øystein Moseng
  *
- *  Place desriptions on a series and its points.
+ *  Place descriptions on a series and its points.
  *
  *  A commercial license may be required depending on use.
  *  See www.highcharts.com/license
@@ -19,14 +19,12 @@ import F from '../../../Core/Templating.js';
 const { format, numberFormat } = F;
 import HTMLUtilities from '../../Utils/HTMLUtilities.js';
 const { reverseChildNodes, stripHTMLTagsFromString: stripHTMLTags } = HTMLUtilities;
-import U from '../../../Core/Utilities.js';
-const { find, isNumber, isString, pick, defined } = U;
+import { defined, find, isString, isNumber, pick } from '../../../Shared/Utilities.js';
 /* *
  *
  *  Functions
  *
  * */
-/* eslint-disable valid-jsdoc */
 /**
  * @private
  */
@@ -172,7 +170,7 @@ function getPointA11yTimeDescription(point) {
     if (dateXAxis) {
         const tooltipDateFormat = dateXAxis.getXDateFormat(point.x || 0, chart.options.tooltip.dateTimeLabelFormats), dateFormat = seriesA11yOptions.dateFormatter &&
             seriesA11yOptions.dateFormatter(point) ||
-            a11yOptions.dateFormatter && a11yOptions.dateFormatter(point) ||
+            a11yOptions.dateFormatter?.(point) ||
             seriesA11yOptions.dateFormat ||
             a11yOptions.dateFormat ||
             tooltipDateFormat;

package/es-modules/Accessibility/Components/SeriesComponent/SeriesKeyboardNavigation.js

@@ -17,18 +17,16 @@ import SeriesRegistry from '../../../Core/Series/SeriesRegistry.js';
 const { seriesTypes } = SeriesRegistry;
 import H from '../../../Core/Globals.js';
 const { doc } = H;
-import U from '../../../Core/Utilities.js';
-const { defined, fireEvent } = U;
 import KeyboardNavigationHandler from '../../KeyboardNavigationHandler.js';
 import EventProvider from '../../Utils/EventProvider.js';
 import ChartUtilities from '../../Utils/ChartUtilities.js';
+import { defined, fireEvent } from '../../../Shared/Utilities.js';
 const { getPointFromXY, getSeriesFromName, scrollAxisToPoint } = ChartUtilities;
 /* *
  *
  *  Functions
  *
  * */
-/* eslint-disable valid-jsdoc */
 /**
  * Get the index of a point in a series. This is needed when using e.g. data
  * grouping.
@@ -177,7 +175,6 @@ class SeriesKeyboardNavigation {
      *  Functions
      *
      * */
-    /* eslint-disable valid-jsdoc */
     /**
      * Init the keyboard navigation
      */

package/es-modules/Accessibility/Components/ZoomComponent.js

@@ -17,8 +17,7 @@ const { unhideChartElementFromAT } = CU;
 import HU from '../Utils/HTMLUtilities.js';
 const { getFakeMouseEvent } = HU;
 import KeyboardNavigationHandler from '../KeyboardNavigationHandler.js';
-import U from '../../Core/Utilities.js';
-const { attr, pick } = U;
+import { attr, pick } from '../../Shared/Utilities.js';
 /* *
  *
  *  Functions

package/es-modules/Accessibility/FocusBorder.js

@@ -11,8 +11,7 @@
  *
  * */
 'use strict';
-import U from '../Core/Utilities.js';
-const { addEvent, pick } = U;
+import { addEvent, pick } from '../Shared/Utilities.js';
 /* *
  *
  *  Composition
@@ -118,7 +117,7 @@ var FocusBorderComposition;
      * Add hook to destroy focus border if SVG element is destroyed, unless
      * hook already exists.
      * @private
-     * @param el Element to add destroy hook to
+     * @param {object} el Element to add destroy hook to
      */
     function svgElementAddDestroyFocusBorderHook(el) {
         if (el.focusBorderDestroyHook) {
@@ -226,8 +225,8 @@ var FocusBorderComposition;
      * Add hooks to update the focus border of an element when the element
      * size/position is updated, unless already added.
      * @private
-     * @param el Element to add update hooks to
-     * @param updateParams Parameters to pass through to addFocusBorder when updating.
+     * @param {object} el Element to add update hooks to
+     * @param {...*} updateParams Parameters to pass through to addFocusBorder when updating.
      */
     function avgElementAddUpdateFocusBorderHooks(el, ...updateParams) {
         if (el.focusBorderUpdateHooks) {
@@ -249,7 +248,7 @@ var FocusBorderComposition;
      * Remove hook from SVG element added by addDestroyFocusBorderHook, if
      * existing.
      * @private
-     * @param el Element to remove destroy hook from
+     * @param {object} el Element to remove destroy hook from
      */
     function svgElementRemoveDestroyFocusBorderHook(el) {
         if (!el.focusBorderDestroyHook) {
@@ -276,7 +275,7 @@ var FocusBorderComposition;
      * Remove hooks from SVG element added by addUpdateFocusBorderHooks, if
      * existing.
      * @private
-     * @param el Element to remove update hooks from
+     * @param {object} el Element to remove update hooks from
      */
     function svgElementRemoveUpdateFocusBorderHooks(el) {
         if (!el.focusBorderUpdateHooks) {

package/es-modules/Accessibility/KeyboardNavigation.js

@@ -14,10 +14,9 @@
 import H from '../Core/Globals.js';
 const { doc, win } = H;
 import MenuComponent from './Components/MenuComponent.js';
-import U from '../Core/Utilities.js';
-const { addEvent, defined, fireEvent } = U;
 import EventProvider from './Utils/EventProvider.js';
 import HTMLUtilities from './Utils/HTMLUtilities.js';
+import { addEvent, defined, fireEvent } from '../Shared/Utilities.js';
 const { getElement, simulatedEventTarget } = HTMLUtilities;
 /* *
  *

package/es-modules/Accessibility/KeyboardNavigationHandler.js

@@ -11,8 +11,7 @@
  *
  * */
 'use strict';
-import U from '../Core/Utilities.js';
-const { find } = U;
+import { find } from '../Shared/Utilities.js';
 /* *
  *
  *  Class

package/es-modules/Accessibility/Options/A11yDefaults.d.ts

@@ -51,6 +51,13 @@ import type { DeepPartial } from '../../Shared/Types';
  * @param {global.MouseEvent} evt
  *        Mouse click event
  *
+ * @param {Highcharts.Chart} [chart]
+ *        Chart context.
+ *
+ * @param {global.GlobalEventHandlers} [ctx]
+ *        Since v12.5.0, the global event handlers context passed as an extra
+ *        argument for arrow functions.
+ *
  * @return {void}
  */
 /**
@@ -61,6 +68,10 @@ import type { DeepPartial } from '../../Shared/Types';
  * @param {T} context
  *        Context to format
  *
+ * @param {*} [outerContext]
+ *        Since v12.5.0, the outer context passed as an extra argument for
+ *        arrow functions.
+ *
  * @return {string}
  *         Formatted string for the screen reader module.
  */

package/es-modules/Accessibility/Options/A11yDefaults.js

@@ -69,6 +69,13 @@
  * @param {global.MouseEvent} evt
  *        Mouse click event
  *
+ * @param {Highcharts.Chart} [chart]
+ *        Chart context.
+ *
+ * @param {global.GlobalEventHandlers} [ctx]
+ *        Since v12.5.0, the global event handlers context passed as an extra
+ *        argument for arrow functions.
+ *
  * @return {void}
  */
 /**
@@ -79,6 +86,10 @@
  * @param {T} context
  *        Context to format
  *
+ * @param {*} [outerContext]
+ *        Since v12.5.0, the outer context passed as an extra argument for
+ *        arrow functions.
+ *
  * @return {string}
  *         Formatted string for the screen reader module.
  */

package/es-modules/Accessibility/Options/DeprecatedOptions.d.ts

@@ -12,6 +12,64 @@ declare module '../../Core/Options' {
         exposeElementToA11y?: SeriesAccessibilityOptions['exposeAsGroupOnly'];
     }
 }
+declare module '../../Core/Series/SeriesOptions' {
+    interface SeriesOptions {
+        /**
+         * Deprecated. Use
+         * [plotOptions.series.accessibility.description](#plotOptions.series.accessibility.description)
+         * instead.
+         *
+         * A description of the series to add to the screen reader information
+         * about the series.
+         *
+         * @since      5.0.0
+         * @requires   modules/accessibility
+         * @deprecated 8.0.0
+         */
+        description?: SeriesAccessibilityOptions['description'];
+        /**
+         * Deprecated. Use
+         * [plotOptions.series.accessibility.point.descriptionFormatter](#plotOptions.series.accessibility.point.descriptionFormatter)
+         * instead.
+         *
+         * Same as
+         * [accessibility.series.descriptionFormatter](#accessibility.series.descriptionFormatter),
+         * but for an individual series. Overrides the chart wide configuration.
+         *
+         * @requires   modules/accessibility
+         * @since      5.0.12
+         * @deprecated 8.0.0
+         */
+        pointDescriptionFormatter?: SeriesAccessibilityOptions['point']['descriptionFormatter'];
+        /**
+         * Deprecated. Use
+         * [plotOptions.series.accessibility.point.descriptionFormat](#plotOptions.series.accessibility.point.descriptionFormat)
+         * instead.
+         *
+         * Same as
+         * [accessibility.point.descriptionFormat](#accessibility.point.descriptionFormat),
+         * but for an individual series. Overrides the chart wide configuration.
+         *
+         * @requires   modules/accessibility
+         * @since      11.1.0
+         * @deprecated next
+         */
+        pointDescriptionFormat?: SeriesAccessibilityOptions['point']['descriptionFormat'];
+        /**
+         * Deprecated. Use
+         * [series.accessibility.keyboardNavigation](#plotOptions.series.accessibility.keyboardNavigation)
+         * instead.
+         *
+         * If set to `true`, the accessibility module will skip past the points
+         * in this series for keyboard navigation.
+         *
+         * @requires   modules/accessibility
+         * @since      5.0.12
+         * @deprecated 8.0.0
+         */
+        skipKeyboardNavigation?: boolean;
+    }
+}
 /**
  * Copy options that are deprecated over to new options. Logs warnings to
  * console if deprecated options are used.

package/es-modules/Accessibility/Options/DeprecatedOptions.js

@@ -18,6 +18,8 @@
  *  chart.typeDescription -> accessibility.typeDescription
  *  series.description -> series.accessibility.description
  *  series.exposeElementToA11y -> series.accessibility.exposeAsGroupOnly
+ *  series.pointDescriptionFormat ->
+ *      series.accessibility.point.descriptionFormat
  *  series.pointDescriptionFormatter ->
  *      series.accessibility.pointDescriptionFormatter
  *  series.accessibility.pointDescriptionFormatter ->
@@ -61,19 +63,18 @@
  */
 /* eslint-enable max-len */
 'use strict';
-import U from '../../Core/Utilities.js';
-const { error, pick } = U;
+import { pick } from '../../Shared/Utilities.js';
+import { error } from '../../Core/Utilities.js';
 /* *
  *
  *  Functions
  *
  * */
-/* eslint-disable valid-jsdoc */
 /**
  * Set a new option on a root prop, where the option is defined as an array of
  * suboptions.
  * @private
- * @param root
+ * @param {Record<string, *>} root
  * @param {Array<string>} optionAsArray
  * @param {*} val
  * @return {void}
@@ -147,6 +148,9 @@ function copyDeprecatedSeriesOptions(chart) {
     const oldToNewSeriesOptions = {
         description: ['accessibility', 'description'],
         exposeElementToA11y: ['accessibility', 'exposeAsGroupOnly'],
+        pointDescriptionFormat: [
+            'accessibility', 'point', 'descriptionFormat'
+        ],
         pointDescriptionFormatter: [
             'accessibility', 'point', 'descriptionFormatter'
         ],

package/es-modules/Accessibility/Options/LangDefaults.js

@@ -208,6 +208,15 @@ const langOptions = {
              */
             changeAnnouncement: '{axisRangeDescription}'
         },
+        /**
+         * Stock tools language options for accessibility.
+         *
+         * @since next
+         */
+        stockTools: {
+            groupLabel: 'Stock chart tools',
+            arrowLabel: 'Toggle submenu'
+        },
         /**
          * Accessibility language options for the data table.
          *

package/es-modules/Accessibility/ProxyElement.d.ts

@@ -35,8 +35,8 @@ declare class ProxyElement {
     /**
      * Update the target to be proxied. The position and events are updated to
      * match the new target.
-     * @param target The new target definition
-     * @param attributes New HTML attributes to apply to the proxy. Set an
+     * @param {object} target The new target definition
+     * @param {object} attributes New HTML attributes to apply to the proxy. Set an
      * attribute to null to remove.
      */
     updateTarget(target: ProxyElement.Target, attributes?: NullableHTMLAttributes): void;