@highcharts/grid-pro 2.1.1 → 2.3.0

package/es-modules/Core/HttpUtilities.js

@@ -1,17 +1,17 @@
 /* *
  *
- *  (c) 2010-2025 Christer Vasseng, Torstein Honsi
+ *  (c) 2010-2026 Highsoft AS
+ *  Author: Christer Vasseng, Torstein Honsi
  *
- *  License: www.highcharts.com/license
+ *  A commercial license may be required depending on use.
+ *  See www.highcharts.com/license
  *
- *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
  *
  * */
 'use strict';
 import G from '../Core/Globals.js';
 const { win } = G;
-import U from '../Core/Utilities.js';
-const { discardElement, objectEach } = U;
+import { discardElement, objectEach } from '../Shared/Utilities.js';
 /* *
  *
  *  Functions
@@ -37,9 +37,7 @@ function ajax(settings) {
     }, r = new XMLHttpRequest();
     /**
      * Private error handler.
-     *
-     * @private
-     *
+     * @internal
      * @param {XMLHttpRequest} xhr
      * Internal request object.
      * @param {string | Error} err
@@ -120,13 +118,15 @@ function getJSON(url, success) {
 /**
  * The post utility.
  *
- * @private
+ * @internal
  * @function Highcharts.post
  *
  * @param {string} url
  * Post URL.
+ *
  * @param {Object} data
  * Post data.
+ *
  * @param {RequestInit} [fetchOptions]
  * Additional attributes for the post request.
  */
@@ -157,16 +157,16 @@ async function post(url, data, fetchOptions) {
         discardElement(link);
     }
 }
-/* *
- *
- *  Default Export
- *
- * */
+/**
+ * Utility functions for Ajax.
+ * @class
+ * @name Highcharts.HttpUtilities
+ */
 const HttpUtilities = {
     ajax,
-    getJSON,
-    post
+    getJSON
 };
+HttpUtilities.post = post;
 export default HttpUtilities;
 /* *
  *

package/es-modules/Core/JSON.d.ts

@@ -0,0 +1,29 @@
+export declare namespace JSON {
+    /**
+     * Type structor of arrays as it is supported in JSON.
+     */
+    interface Array extends globalThis.Array<(Primitive | Type)> {
+        [index: number]: (Primitive | Type);
+    }
+    /**
+     * Class API for toJSON implementation based on JSON.stringify.
+     */
+    interface Builder {
+        toJSON(): Type;
+    }
+    /**
+     * Type structure of a record object as it is supported in JSON.
+     */
+    interface Object {
+        [key: string]: (Primitive | Type);
+    }
+    /**
+     * All primitive types, that are supported in JSON.
+     */
+    type Primitive = (boolean | number | string | null | undefined);
+    /**
+     * All object types, that are supported in JSON.
+     */
+    type Type = (Array | Object);
+}
+export default JSON;

package/es-modules/Core/JSON.js

@@ -0,0 +1,13 @@
+/* *
+ *
+ *  (c) 2020-2026 Highsoft AS
+ *
+ *  A commercial license may be required depending on use.
+ *  See www.highcharts.com/license
+ *
+ *
+ *  Authors:
+ *  - Sophie Bremer
+ *
+ * */
+export {};

package/es-modules/Core/KeyboardEvent.d.ts

@@ -0,0 +1 @@
+export {};

package/es-modules/Core/KeyboardEvent.js

@@ -0,0 +1,11 @@
+/* *
+ *
+ *  (c) 2010-2026 Highsoft AS
+ *  Author: Torstein Honsi
+ *
+ *  A commercial license may be required depending on use.
+ *  See www.highcharts.com/license
+ *
+ *
+ * */
+export {};

package/es-modules/Core/MSPointer.d.ts

@@ -1,74 +1 @@
-import type Chart from './Chart/Chart';
-import type Options from './Options';
-import type PointerEvent from './PointerEvent';
-import Pointer from './Pointer.js';
-import DOMElementType from './Renderer/DOMElementType';
-declare global {
-    /** @deprecated */
-    interface MSPointerEvent extends Partial<PointerEvent> {
-        /** @deprecated */
-        readonly MSPOINTER_TYPE_TOUCH: string;
-        readonly currentTarget?: EventTarget;
-        readonly pointerId: number;
-        readonly pointerType?: undefined;
-        /** @deprecated */
-        readonly toElement: Element;
-    }
-    interface Window {
-        /** @deprecated */
-        MSPointerEvent?: Class<MSPointerEvent>;
-    }
-}
-/** @private */
-declare class MSPointer extends Pointer {
-    static isRequired(): boolean;
-    /**
-     * Add or remove the MS Pointer specific events
-     * @private
-     * @function Highcharts.Pointer#batchMSEvents
-     */
-    private batchMSEvents;
-    destroy(): void;
-    constructor(chart: Chart, options: Options);
-    /**
-     * Utility to detect whether an element has, or has a parent with, a
-     * specific class name. Used on detection of tracker objects and on deciding
-     * whether hovering the tooltip should cause the active series to mouse out.
-     *
-     * @function Highcharts.Pointer#inClass
-     *
-     * @param {Highcharts.SVGDOMElement|Highcharts.HTMLDOMElement} element
-     * The element to investigate.
-     *
-     * @param {string} className
-     * The class name to look for.
-     *
-     * @return {boolean|undefined}
-     * True if either the element or one of its parents has the given class
-     * name.
-     */
-    inClass(element: DOMElementType, className: string): (boolean | undefined);
-    /**
-     * @private
-     * @function Highcharts.Pointer#onContainerPointerDown
-     */
-    private onContainerPointerDown;
-    /**
-     * @private
-     * @function Highcharts.Pointer#onContainerPointerMove
-     */
-    private onContainerPointerMove;
-    /**
-     * @private
-     * @function Highcharts.Pointer#onDocumentPointerUp
-     */
-    private onDocumentPointerUp;
-    setDOMEvents(): void;
-}
-declare namespace MSPointer {
-    /**
-     * @private
-     */
-    function compose(ChartClass: typeof Chart): void;
-}
-export default MSPointer;
+export {};

package/es-modules/Core/MSPointer.js

@@ -1,18 +1,18 @@
 /* *
  *
- *  (c) 2010-2025 Torstein Honsi
+ *  (c) 2010-2026 Highsoft AS
+ *  Author: Torstein Honsi
  *
- *  License: www.highcharts.com/license
+ *  A commercial license may be required depending on use.
+ *  See www.highcharts.com/license
  *
- *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
  *
  * */
 'use strict';
 import H from './Globals.js';
 const { charts, composed, doc, noop, win } = H;
 import Pointer from './Pointer.js';
-import U from './Utilities.js';
-const { addEvent, attr, css, defined, objectEach, pick, pushUnique, removeEvent } = U;
+import { addEvent, attr, css, defined, objectEach, pick, pushUnique, removeEvent } from '../Shared/Utilities.js';
 /* *
  *
  *  Constants
@@ -27,7 +27,7 @@ const hasPointerEvent = !!win.PointerEvent;
  *
  * */
 /* eslint-disable valid-jsdoc */
-/** @private */
+/** @internal */
 function getWebkitTouches() {
     const fake = [];
     fake.item = function (i) {
@@ -42,7 +42,7 @@ function getWebkitTouches() {
     });
     return fake;
 }
-/** @private */
+/** @internal */
 function translateMSPointer(e, method, wktype, func) {
     const pointer = charts[Pointer.hoverChartIndex ?? -1]?.pointer;
     if (pointer &&
@@ -62,13 +62,22 @@ function translateMSPointer(e, method, wktype, func) {
  *  Class
  *
  * */
-/** @private */
+/** @internal */
 class MSPointer extends Pointer {
     /* *
      *
      *  Static Functions
      *
      * */
+    /**
+     * The isRequired method is required for Highcharts to decide whether to use
+     * this module.
+     *
+     * @internal
+     *
+     * @return {boolean}
+     * Returns true if the module is required.
+     */
     static isRequired() {
         return !!(!win.TouchEvent && (win.PointerEvent || win.MSPointerEvent));
     }
@@ -79,7 +88,7 @@ class MSPointer extends Pointer {
      * */
     /**
      * Add or remove the MS Pointer specific events
-     * @private
+     * @internal
      * @function Highcharts.Pointer#batchMSEvents
      */
     batchMSEvents(fn) {
@@ -144,7 +153,7 @@ class MSPointer extends Pointer {
         }
     }
     /**
-     * @private
+     * @internal
      * @function Highcharts.Pointer#onContainerPointerDown
      */
     onContainerPointerDown(e) {
@@ -157,7 +166,7 @@ class MSPointer extends Pointer {
         });
     }
     /**
-     * @private
+     * @internal
      * @function Highcharts.Pointer#onContainerPointerMove
      */
     onContainerPointerMove(e) {
@@ -169,7 +178,7 @@ class MSPointer extends Pointer {
         });
     }
     /**
-     * @private
+     * @internal
      * @function Highcharts.Pointer#onDocumentPointerUp
      */
     onDocumentPointerUp(e) {
@@ -192,15 +201,14 @@ class MSPointer extends Pointer {
  *  Class Namespace
  *
  * */
+/** @internal */
 (function (MSPointer) {
     /* *
      *
      *  Functions
      *
      * */
-    /**
-     * @private
-     */
+    /** @internal */
     function compose(ChartClass) {
         if (pushUnique(composed, 'Core.MSPointer')) {
             addEvent(ChartClass, 'beforeRender', function () {
@@ -215,4 +223,5 @@ class MSPointer extends Pointer {
  *  Default Export
  *
  * */
+/** @internal */
 export default MSPointer;

package/es-modules/Core/Math3D.d.ts

@@ -1,117 +1 @@
-import type Chart from './Chart/Chart';
-import type Position3DObject from './Renderer/Position3DObject';
-import type PositionObject from './Renderer/PositionObject';
-declare module './Chart/ChartBase' {
-    interface ChartBase {
-        scale3d?: number;
-    }
-}
-/**
- * Transforms a given array of points according to the angles in chart.options.
- *
- * @private
- * @function Highcharts.perspective
- *
- * @param {Array<Highcharts.Position3DObject>} points
- * The array of points
- *
- * @param {Highcharts.Chart} chart
- * The chart
- *
- * @param {boolean} [insidePlotArea]
- * Whether to verify that the points are inside the plotArea
- *
- * @param {boolean} [useInvertedPersp]
- * Whether to use inverted perspective in calculations
- *
- * @return {Array<Highcharts.Position3DObject>}
- * An array of transformed points
- *
- * @requires highcharts-3d
- */
-declare function perspective(points: Array<Position3DObject>, chart: Chart, insidePlotArea?: boolean, useInvertedPersp?: boolean): Array<Position3DObject>;
-/**
- * Perspective3D function is available in global Highcharts scope because is
- * needed also outside of perspective() function (#8042).
- * @private
- * @function Highcharts.perspective3D
- *
- * @param {Highcharts.Position3DObject} coordinate
- * 3D position
- *
- * @param {Highcharts.Position3DObject} origin
- * 3D root position
- *
- * @param {number} distance
- * Perspective distance
- *
- * @return {Highcharts.PositionObject}
- * Perspective 3D Position
- *
- * @requires highcharts-3d
- */
-declare function perspective3D(coordinate: Position3DObject, origin: Position3DObject, distance: number): PositionObject;
-/**
- * Calculate a distance from camera to points - made for calculating zIndex of
- * scatter points.
- *
- * @private
- * @function Highcharts.pointCameraDistance
- *
- * @param {Highcharts.Dictionary<number>} coordinates
- * Coordinates of the specific point
- *
- * @param {Highcharts.Chart} chart
- * Related chart
- *
- * @return {number}
- * Distance from camera to point
- *
- * @requires highcharts-3d
- */
-declare function pointCameraDistance(coordinates: Record<string, number>, chart: Chart): number;
-/**
- * Calculate area of a 2D polygon using Shoelace algorithm
- * https://en.wikipedia.org/wiki/Shoelace_formula
- *
- * @private
- * @function Highcharts.shapeArea
- *
- * @param {Array<Highcharts.PositionObject>} vertexes
- * 2D Polygon
- *
- * @return {number}
- * Calculated area
- *
- * @requires highcharts-3d
- */
-declare function shapeArea(vertexes: Array<PositionObject>): number;
-/**
- * Calculate area of a 3D polygon after perspective projection
- *
- * @private
- * @function Highcharts.shapeArea3d
- *
- * @param {Array<Highcharts.Position3DObject>} vertexes
- * 3D Polygon
- *
- * @param {Highcharts.Chart} chart
- * Related chart
- *
- * @param {boolean} [insidePlotArea]
- * Whether to verify that the points are inside the plotArea
- *
- * @return {number}
- * Calculated area
- *
- * @requires highcharts-3d
- */
-declare function shapeArea3D(vertexes: Array<Position3DObject>, chart: Chart, insidePlotArea?: boolean): number;
-declare const Math3D: {
-    perspective: typeof perspective;
-    perspective3D: typeof perspective3D;
-    pointCameraDistance: typeof pointCameraDistance;
-    shapeArea: typeof shapeArea;
-    shapeArea3D: typeof shapeArea3D;
-};
-export default Math3D;
+export {};

package/es-modules/Core/Math3D.js

@@ -1,17 +1,17 @@
 /* *
  *
- *  (c) 2010-2025 Torstein Honsi
+ *  (c) 2010-2026 Highsoft AS
+ *  Author: Torstein Honsi
  *
- *  License: www.highcharts.com/license
+ *  A commercial license may be required depending on use.
+ *  See www.highcharts.com/license
  *
- *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
  *
  * */
 'use strict';
 import H from './Globals.js';
+import { pick } from '../Shared/Utilities.js';
 const { deg2rad } = H;
-import U from './Utilities.js';
-const { pick } = U;
 /* *
  *
  *  Functions
@@ -42,13 +42,13 @@ const { pick } = U;
  * | - sinA * sinB |  cosA  | - sinA * cosB |  x  | y |  =  | py |
  * |  cosA * sinB  |  sinA  |  cosA * cosB  |     | z |     | pz |
  *
- * @private
+ * @internal
  * @function rotate3D
  */
 /* eslint-enable max-len */
 /**
  * Rotates the position as defined in angles.
- * @private
+ * @internal
  * @param {number} x
  *        X coordinate
  * @param {number} y
@@ -72,7 +72,7 @@ function rotate3D(x, y, z, angles) {
 /**
  * Transforms a given array of points according to the angles in chart.options.
  *
- * @private
+ * @internal
  * @function Highcharts.perspective
  *
  * @param {Array<Highcharts.Position3DObject>} points
@@ -131,7 +131,7 @@ function perspective(points, chart, insidePlotArea, useInvertedPersp) {
 /**
  * Perspective3D function is available in global Highcharts scope because is
  * needed also outside of perspective() function (#8042).
- * @private
+ * @internal
  * @function Highcharts.perspective3D
  *
  * @param {Highcharts.Position3DObject} coordinate
@@ -162,7 +162,7 @@ function perspective3D(coordinate, origin, distance) {
  * Calculate a distance from camera to points - made for calculating zIndex of
  * scatter points.
  *
- * @private
+ * @internal
  * @function Highcharts.pointCameraDistance
  *
  * @param {Highcharts.Dictionary<number>} coordinates
@@ -193,7 +193,7 @@ function pointCameraDistance(coordinates, chart) {
  * Calculate area of a 2D polygon using Shoelace algorithm
  * https://en.wikipedia.org/wiki/Shoelace_formula
  *
- * @private
+ * @internal
  * @function Highcharts.shapeArea
  *
  * @param {Array<Highcharts.PositionObject>} vertexes
@@ -215,7 +215,7 @@ function shapeArea(vertexes) {
 /**
  * Calculate area of a 3D polygon after perspective projection
  *
- * @private
+ * @internal
  * @function Highcharts.shapeArea3d
  *
  * @param {Array<Highcharts.Position3DObject>} vertexes
@@ -240,6 +240,7 @@ function shapeArea3D(vertexes, chart, insidePlotArea) {
  *  Default Export
  *
  * */
+/** @internal */
 const Math3D = {
     perspective,
     perspective3D,
@@ -247,4 +248,5 @@ const Math3D = {
     shapeArea,
     shapeArea3D
 };
+/** @internal */
 export default Math3D;