@highcharts/grid-pro 2.1.1 → 2.3.0

package/es-modules/Core/Geometry/CircleUtilities.js

@@ -1,22 +1,22 @@
 /* *
  *
- *  (c) 2010-2025 Highsoft AS
+ *  (c) 2010-2026 Highsoft AS
  *
- *  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 Geometry from './GeometryUtilities.js';
-import Utilities from '../Utilities';
+import { correctFloat } from '../../Shared/Utilities.js';
 const { getAngleBetweenPoints, getCenterOfPoints, getDistanceBetweenPoints } = Geometry;
-const { correctFloat } = Utilities;
 /* *
  *
  *  Namespace
  *
  * */
+/** @internal */
 var CircleUtilities;
 (function (CircleUtilities) {
     /* *
@@ -25,7 +25,7 @@ var CircleUtilities;
      *
      * */
     /**
-     * @private
+     * @internal
      *
      * @param {number} x
      * Number to round
@@ -44,7 +44,7 @@ var CircleUtilities;
     /**
      * Calculates the area of a circle based on its radius.
      *
-     * @private
+     * @internal
      *
      * @param {number} r
      * The radius of the circle.
@@ -65,7 +65,7 @@ var CircleUtilities;
      *
      * @see http://mathworld.wolfram.com/CircularSegment.html
      *
-     * @private
+     * @internal
      *
      * @param {number} r
      * The radius of the circle.
@@ -87,7 +87,7 @@ var CircleUtilities;
      *
      * @see http://mathworld.wolfram.com/Circle-CircleIntersection.html
      *
-     * @private
+     * @internal
      *
      * @param {number} r1
      * Radius of the first circle.
@@ -130,7 +130,7 @@ var CircleUtilities;
      *
      * NOTE: does not handle floating errors well.
      *
-     * @private
+     * @internal
      *
      * @param {Highcharts.CircleObject} c1
      * The first circle.
@@ -163,7 +163,7 @@ var CircleUtilities;
     /**
      * Calculates all the intersection points for between a list of circles.
      *
-     * @private
+     * @internal
      *
      * @param {Array<Highcharts.CircleObject>} circles
      * The circles to calculate the points from.
@@ -190,7 +190,7 @@ var CircleUtilities;
      * Tests whether the first circle is completely overlapping the second
      * circle.
      *
-     * @private
+     * @internal
      *
      * @param {Highcharts.CircleObject} circle1
      * The first circle.
@@ -207,7 +207,7 @@ var CircleUtilities;
     CircleUtilities.isCircle1CompletelyOverlappingCircle2 = isCircle1CompletelyOverlappingCircle2;
     /**
      * Tests whether a point lies within a given circle.
-     * @private
+     * @internal
      * @param {Highcharts.PositionObject} point
      * The point to test for.
      *
@@ -224,7 +224,7 @@ var CircleUtilities;
     /**
      * Tests whether a point lies within a set of circles.
      *
-     * @private
+     * @internal
      *
      * @param {Highcharts.PositionObject} point
      * The point to test.
@@ -246,7 +246,7 @@ var CircleUtilities;
      *
      * TODO: add unit tests.
      *
-     * @private
+     * @internal
      *
      * @param {Highcharts.PositionObject} point
      * The point to test.
@@ -267,7 +267,7 @@ var CircleUtilities;
      * Calculates the points for the polygon of the intersection area between
      * a set of circles.
      *
-     * @private
+     * @internal
      *
      * @param {Array<Highcharts.CircleObject>} circles
      * List of circles to calculate polygon of.
@@ -287,7 +287,7 @@ var CircleUtilities;
      *
      * @todo handle cases with only 1 or 0 arcs.
      *
-     * @private
+     * @internal
      *
      * @param {Array<Highcharts.CircleObject>} circles
      * List of circles to calculate area of.
@@ -385,4 +385,5 @@ var CircleUtilities;
  *  Default Export
  *
  * */
+/** @internal */
 export default CircleUtilities;

package/es-modules/Core/Geometry/GeometryObject.d.ts

@@ -0,0 +1,7 @@
+import type PositionObject from '../Renderer/PositionObject';
+export interface GeometryObject extends PositionObject {
+    angle?: number;
+    r?: number;
+    indexes?: [number, number];
+}
+export default GeometryObject;

package/es-modules/Core/Geometry/GeometryObject.js

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

package/es-modules/Core/Geometry/GeometryUtilities.d.ts

@@ -1,48 +1 @@
-import type PositionObject from '../Renderer/PositionObject';
-declare namespace GeometryUtilities {
-    /**
-     * Calculates the center between a list of points.
-     *
-     * @private
-     *
-     * @param {Array<Highcharts.PositionObject>} points
-     * A list of points to calculate the center of.
-     *
-     * @return {Highcharts.PositionObject}
-     * Calculated center
-     */
-    function getCenterOfPoints(points: Array<PositionObject>): PositionObject;
-    /**
-     * Calculates the distance between two points based on their x and y
-     * coordinates.
-     *
-     * @private
-     *
-     * @param {Highcharts.PositionObject} p1
-     * The x and y coordinates of the first point.
-     *
-     * @param {Highcharts.PositionObject} p2
-     * The x and y coordinates of the second point.
-     *
-     * @return {number}
-     * Returns the distance between the points.
-     */
-    function getDistanceBetweenPoints(p1: PositionObject, p2: PositionObject): number;
-    /**
-     * Calculates the angle between two points.
-     * @todo add unit tests.
-     * @private
-     * @param {Highcharts.PositionObject} p1 The first point.
-     * @param {Highcharts.PositionObject} p2 The second point.
-     * @return {number} Returns the angle in radians.
-     */
-    function getAngleBetweenPoints(p1: PositionObject, p2: PositionObject): number;
-    /**
-     * Test for point in polygon. Polygon defined as array of [x,y] points.
-     * @private
-     * @param {PositionObject} point The point potentially within a polygon.
-     * @param {Array<Array<number>>} polygon The polygon potentially containing the point.
-     */
-    function pointInPolygon({ x, y }: PositionObject, polygon: Array<Array<number>>): boolean;
-}
-export default GeometryUtilities;
+export {};

package/es-modules/Core/Geometry/GeometryUtilities.js

@@ -1,10 +1,10 @@
 /* *
  *
- *  (c) 2010-2025 Highsoft AS
+ *  (c) 2010-2026 Highsoft AS
  *
- *  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';
@@ -13,6 +13,7 @@
  *  Namespace
  *
  * */
+/** @internal */
 var GeometryUtilities;
 (function (GeometryUtilities) {
     /* *
@@ -23,7 +24,7 @@ var GeometryUtilities;
     /**
      * Calculates the center between a list of points.
      *
-     * @private
+     * @internal
      *
      * @param {Array<Highcharts.PositionObject>} points
      * A list of points to calculate the center of.
@@ -47,7 +48,7 @@ var GeometryUtilities;
      * Calculates the distance between two points based on their x and y
      * coordinates.
      *
-     * @private
+     * @internal
      *
      * @param {Highcharts.PositionObject} p1
      * The x and y coordinates of the first point.
@@ -65,7 +66,7 @@ var GeometryUtilities;
     /**
      * Calculates the angle between two points.
      * @todo add unit tests.
-     * @private
+     * @internal
      * @param {Highcharts.PositionObject} p1 The first point.
      * @param {Highcharts.PositionObject} p2 The second point.
      * @return {number} Returns the angle in radians.
@@ -76,7 +77,7 @@ var GeometryUtilities;
     GeometryUtilities.getAngleBetweenPoints = getAngleBetweenPoints;
     /**
      * Test for point in polygon. Polygon defined as array of [x,y] points.
-     * @private
+     * @internal
      * @param {PositionObject} point The point potentially within a polygon.
      * @param {Array<Array<number>>} polygon The polygon potentially containing the point.
      */
@@ -102,4 +103,5 @@ var GeometryUtilities;
  *  Default Export
  *
  * */
+/** @internal */
 export default GeometryUtilities;

package/es-modules/Core/Geometry/IntersectionObject.d.ts

@@ -0,0 +1,7 @@
+import type PositionObject from '../Renderer/PositionObject';
+import type SVGPath from '../Renderer/SVG/SVGPath';
+export interface IntersectionObject {
+    center: PositionObject;
+    d: SVGPath;
+}
+export default IntersectionObject;

package/es-modules/Core/Geometry/IntersectionObject.js

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

package/es-modules/Core/Geometry/PolygonClip.d.ts

@@ -1,19 +1 @@
-interface XYArray extends XYPair {
-    isIntersection?: boolean;
-}
-type XYPair = [number, number];
-/**
- * Simple line string clipping. Clip to bounds and insert intersection points.
- * @private
- */
-declare function clipLineString(line: Array<XYArray>, boundsPolygon: Array<XYArray>): XYArray[][];
-/**
- * Clip a polygon to another polygon using the Sutherland/Hodgman algorithm.
- * @private
- */
-declare function clipPolygon(subjectPolygon: XYArray[], boundsPolygon: XYArray[], closed?: boolean): Array<XYArray>;
-declare const PolygonClip: {
-    clipLineString: typeof clipLineString;
-    clipPolygon: typeof clipPolygon;
-};
-export default PolygonClip;
+export {};

package/es-modules/Core/Geometry/PolygonClip.js

@@ -1,10 +1,10 @@
 /* *
  *
- *  (c) 2010-2025 Highsoft AS
+ *  (c) 2010-2026 Highsoft AS
  *
- *  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';
@@ -15,7 +15,7 @@
  * */
 /**
  * Simple line string clipping. Clip to bounds and insert intersection points.
- * @private
+ * @internal
  */
 function clipLineString(line, boundsPolygon) {
     const ret = [], l = clipPolygon(line, boundsPolygon, false);
@@ -34,7 +34,7 @@ function clipLineString(line, boundsPolygon) {
 }
 /**
  * Clip a polygon to another polygon using the Sutherland/Hodgman algorithm.
- * @private
+ * @internal
  */
 function clipPolygon(subjectPolygon, boundsPolygon, closed = true) {
     let clipEdge1 = boundsPolygon[boundsPolygon.length - 1], clipEdge2, prevPoint, currentPoint, outputList = subjectPolygon;
@@ -64,12 +64,12 @@ function clipPolygon(subjectPolygon, boundsPolygon, closed = true) {
     }
     return outputList;
 }
-/** @private */
+/** @internal */
 function isInside(clipEdge1, clipEdge2, p) {
     return ((clipEdge2[0] - clipEdge1[0]) * (p[1] - clipEdge1[1]) >
         (clipEdge2[1] - clipEdge1[1]) * (p[0] - clipEdge1[0]));
 }
-/** @private */
+/** @internal */
 function intersection(clipEdge1, clipEdge2, prevPoint, currentPoint) {
     const dc = [
         clipEdge1[0] - clipEdge2[0],
@@ -89,8 +89,10 @@ function intersection(clipEdge1, clipEdge2, prevPoint, currentPoint) {
  *  Default Export
  *
  * */
+/** @internal */
 const PolygonClip = {
     clipLineString,
     clipPolygon
 };
+/** @internal */
 export default PolygonClip;

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

@@ -1,4 +1,3 @@
-import type ButtonThemeObject from './Renderer/SVG/ButtonThemeObject';
 import type GlobalsBase from './GlobalsBase';
 declare global {
     type AnyRecord = Record<string, any>;
@@ -35,16 +34,6 @@ declare global {
         webkitHidden: boolean;
     }
     interface Element {
-        /**
-         * @private
-         * @requires Core/Renderer/SVG/SVGElement
-         */
-        gradient?: string;
-        /**
-         * @private
-         * @requires Core/Renderer/SVG/SVGElement
-         */
-        radialReference?: Array<number>;
         setAttribute(qualifiedName: string, value: (boolean | number | string)): void;
         /** @deprecated */
         currentStyle?: ElementCSSInlineStyle;
@@ -63,14 +52,18 @@ declare global {
         parentNode: HTMLElement;
     }
     interface Math {
+        /**
+         * Easing definition
+         *
+         * @param pos
+         * Current position, ranging from 0 to 1.
+         *
+         * @return
+         * Ease result
+         */
         easeInOutSine(pos: number): number;
     }
     interface SVGElement {
-        /**
-         * @private
-         * @requires Core/Renderer/SVG/SVGElement
-         */
-        cutHeight?: number;
         parentNode: SVGElement;
     }
     interface TouchList {
@@ -85,21 +78,6 @@ declare global {
         /** @deprecated */
         webkitURL?: typeof URL;
     }
-    interface GlobalOptions {
-        buttonTheme: ButtonThemeObject;
-        /** @deprecated */
-        canvasToolsURL?: string;
-        /** @deprecated */
-        Date?: Function;
-        /** @deprecated */
-        getTimezoneOffset?: Function;
-        /** @deprecated */
-        timezone?: string;
-        /** @deprecated */
-        timezoneOffset?: number;
-        /** @deprecated */
-        useUTC?: boolean;
-    }
     namespace Intl {
         interface DateTimeFormat {
             formatRange(startDate: Date, endDate: Date): string;

package/es-modules/Core/Globals.js

@@ -1,10 +1,11 @@
 /* *
  *
- *  (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';
@@ -15,7 +16,7 @@
  * */
 /**
  * Shared Highcharts properties.
- * @private
+ * @internal
  */
 var Globals;
 (function (Globals) {
@@ -24,7 +25,7 @@ var Globals;
      *  Constants
      *
      * */
-    Globals.SVG_NS = 'http://www.w3.org/2000/svg', Globals.product = 'Highcharts', Globals.version = '2.1.1', Globals.win = (typeof window !== 'undefined' ?
+    Globals.SVG_NS = 'http://www.w3.org/2000/svg', Globals.product = 'Highcharts', Globals.version = '2.3.0', Globals.win = (typeof window !== 'undefined' ?
         window :
         {}), // eslint-disable-line node/no-unsupported-features/es-builtins
     Globals.doc = Globals.win.document, Globals.svg = !!Globals.doc?.createElementNS?.(Globals.SVG_NS, 'svg')?.createSVGRect, Globals.pageLang = Globals.doc?.documentElement?.closest('[lang]')?.lang, Globals.userAgent = Globals.win.navigator?.userAgent || '', Globals.isChrome = Globals.win.chrome, Globals.isFirefox = Globals.userAgent.indexOf('Firefox') !== -1, Globals.isMS = /(edge|msie|trident)/i.test(Globals.userAgent) && !Globals.win.opera, Globals.isSafari = !Globals.isChrome && Globals.userAgent.indexOf('Safari') !== -1, Globals.isTouchDevice = /(Mobile|Android|Windows Phone)/.test(Globals.userAgent), Globals.isWebKit = Globals.userAgent.indexOf('AppleWebKit') !== -1, Globals.deg2rad = Math.PI * 2 / 360, Globals.marginNames = [
@@ -62,7 +63,7 @@ var Globals;
     /**
      * A shared registry between all bundles to keep track of applied
      * compositions.
-     * @private
+     * @internal
      */
     Globals.composed = [];
     /**
@@ -87,14 +88,12 @@ var Globals;
      */
     Globals.dateFormats = {};
     /**
-     * @private
+     * @internal
      * @deprecated
      * @todo Use only `Core/Series/SeriesRegistry.seriesTypes`
      */
     Globals.seriesTypes = {};
-    /**
-     * @private
-     */
+    /** @internal */
     Globals.symbolSizes = {};
     /* *
      *

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

@@ -0,0 +1,35 @@
+import type Chart from './Chart/Chart';
+import type Time from './Time';
+/**
+ * Helper interface to add property types to `Globals`.
+ *
+ * Use the `declare module 'GlobalsBase'` pattern to overload the interface in
+ * this definition file.
+ */
+export interface GlobalsBase {
+    /**
+     * An array containing the current chart objects in the page. A chart's
+     * position in the array is preserved throughout the page's lifetime. When
+     * a chart is destroyed, the array item becomes `undefined`.
+     */
+    readonly charts: Array<(Chart | undefined)>;
+    /**
+     * A hook for defining additional date format specifiers. New
+     * specifiers are defined as key-value pairs by using the
+     * specifier as key, and a function which takes the timestamp as
+     * value. This function returns the formatted portion of the
+     * date.
+     *
+     * Using `dateFormats` is also a convenient way to define new keys for
+     * complex locale-aware date formats compatible with the
+     * [Intl.DateTimeFormat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat)
+     * browser API, whenever the built-in formats are not sufficient.
+     *
+     * @sample highcharts/global/dateformats/
+     *         Adding support for week number
+     * @sample highcharts/global/dateformats-object/
+     *         A locale-aware date format using `Intl.DateTimeFormat`
+     */
+    readonly dateFormats: Record<string, Time.TimeFormatCallbackFunction>;
+}
+export default GlobalsBase;

package/es-modules/Core/GlobalsBase.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/HttpUtilities.d.ts

@@ -1,17 +1,63 @@
 import type JSON from './JSON';
+/**
+ * Callback function for Ajax errors.
+ *
+ * @callback Highcharts.AjaxErrorCallbackFunction
+ *
+ * @param {XMLHttpRequest} request
+ * The XHR object.
+ *
+ * @param {string|Error} error
+ * The error message.
+ */
 export interface AjaxErrorCallbackFunction {
     (request: XMLHttpRequest, error: (string | Error)): void;
 }
 export interface AjaxSettingsObject {
+    /**
+     * The payload to send.
+     */
     data?: (string | JSON.Type | JSON.Builder | JSON);
+    /**
+     * The data type expected.
+     */
     dataType?: string;
+    /**
+     * Function to call on error.
+     */
     error?: AjaxErrorCallbackFunction;
+    /**
+     * The headers; keyed on header name.
+     */
     headers?: Record<string, string>;
+    /**
+     * The response type.
+     */
     responseType?: ('arraybuffer' | 'blob' | 'document' | 'json' | 'text');
+    /**
+     * Function to call on success.
+     */
     success?: AjaxSuccessCallbackFunction;
+    /**
+     * The HTTP method to use. For example GET or POST.
+     */
     type?: ('get' | 'post' | 'update' | 'delete');
+    /**
+     * The URL to call.
+     */
     url: string;
 }
+/**
+ * Callback function for Ajax success.
+ *
+ * @callback Highcharts.AjaxSuccessCallbackFunction
+ *
+ * @param {string|Highcharts.JSONType} response
+ * The response from the Ajax call.
+ *
+ * @param {XMLHttpRequest} xhr
+ * The XHR object.
+ */
 export interface AjaxSuccessCallbackFunction {
     (response: (string | JSON.Type), xhr: XMLHttpRequest): void;
 }
@@ -39,23 +85,14 @@ declare function ajax(settings: AjaxSettingsObject): (false | undefined);
  * instead.
  */
 declare function getJSON(url: string, success: AjaxSuccessCallbackFunction): void;
-/**
- * The post utility.
- *
- * @private
- * @function Highcharts.post
- *
- * @param {string} url
- * Post URL.
- * @param {Object} data
- * Post data.
- * @param {RequestInit} [fetchOptions]
- * Additional attributes for the post request.
- */
-declare function post(url: string, data: Record<string, any>, fetchOptions?: RequestInit): Promise<void>;
-declare const HttpUtilities: {
+interface HttpUtilities {
     ajax: typeof ajax;
     getJSON: typeof getJSON;
-    post: typeof post;
-};
+}
+/**
+ * Utility functions for Ajax.
+ * @class
+ * @name Highcharts.HttpUtilities
+ */
+declare const HttpUtilities: HttpUtilities;
 export default HttpUtilities;