@highcharts/grid-pro 2.0.1 → 2.1.0

package/es-modules/Core/Renderer/SVG/SVGAttributes3D.d.ts

@@ -0,0 +1,42 @@
+/* *
+ *
+ *  (c) 2010-2025 Torstein Honsi
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+
+/* *
+ *
+ *  Imports
+ *
+ * */
+
+import type Position3DObject from '../../Renderer/Position3DObject';
+import type SVGAttributes from './SVGAttributes';
+
+/* *
+ *
+ *  Declarations
+ *
+ * */
+
+interface SVGAttributes3D extends SVGAttributes {
+    alpha?: number;
+    beta?: number;
+    center?: number;
+    enabled?: (boolean|'auto'|'default');
+    faces?: Array<SVGAttributes3D>;
+    insidePlotArea?: boolean;
+    vertexes?: Array<Position3DObject>;
+}
+
+/* *
+ *
+ *  Default Export
+ *
+ * */
+
+export default SVGAttributes3D;

package/es-modules/Core/Renderer/SVG/SVGCuboid.d.ts

@@ -0,0 +1,42 @@
+/* *
+ *
+ *  (c) 2010-2025 Torstein Honsi
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+
+/* *
+ *
+ *  Imports
+ *
+ * */
+
+import type SVGPath from './SVGPath';
+import type SVGPath3D from './SVGPath3D';
+
+/* *
+ *
+ *  Declarations
+ *
+ * */
+
+export interface SVGCuboid extends SVGPath3D {
+    front: SVGPath;
+    isFront: number;
+    isTop: number;
+    side: SVGPath;
+    top: SVGPath;
+    zIndexes: Record<string, number>;
+    forcedSides?: Array<string>;
+}
+
+/* *
+ *
+ *  Default Export
+ *
+ * */
+
+export default SVGCuboid;

package/es-modules/Core/Renderer/SVG/SVGElementBase.d.ts

@@ -0,0 +1,31 @@
+/* *
+ *
+ *  (c) 2010-2025 Torstein Honsi
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+
+/* *
+ *
+ *  Declarations
+ *
+ * */
+
+/**
+ * Optional properties for the SVGElement class. Should be defined outside of
+ * this file by `declare module` pattern.
+ */
+export interface SVGElementBase {
+    [key: string]: any;
+}
+
+/* *
+ *
+ *  Default Export
+ *
+ * */
+
+export default SVGElementBase;

package/es-modules/Core/Renderer/SVG/SVGPath.d.ts

@@ -0,0 +1,97 @@
+/* *
+ *
+ *  (c) 2010-2025 Torstein Honsi
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+
+/* *
+ *
+ *  Declarations
+ *
+ * */
+
+export interface SVGPath extends globalThis.Array<SVGPath.Segment> {
+    isFlat?: boolean;
+    xBounds?: Array<number>;
+    yBounds?: Array<number>;
+    xMap?: Array<number|null>;
+}
+
+/* *
+ *
+ *  Namespace
+ *
+ * */
+
+export namespace SVGPath {
+
+    /* *
+     *
+     *  Declarations
+     *
+     * */
+    type ArcParams = {
+        cx: number,
+        cy: number,
+        start: number,
+        end: number
+    };
+    type ArcArray = [
+        'A'|'a',
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number
+    ];
+    export interface Arc extends ArcArray {
+        params?: ArcParams
+    }
+
+    export type Close = ['Z'|'z'];
+    export type CurveTo = [
+        'C'|'c',
+        number,
+        number,
+        number,
+        number,
+        number,
+        number
+    ];
+    export type HorizontalLineTo = ['H'|'h', number];
+    export type LineTo = ['L'|'l', number, number];
+    export type MoveTo = ['M'|'m', number, number];
+    export type QuadTo = ['Q'|'q', number, number, number, number];
+    export type CurveSmoothTo = ['S'|'s', number, number, number, number];
+    export type QuadSmoothTo = ['T'|'t', number, number];
+    export type VerticalLineTo = ['V'|'v', number];
+
+    export type Segment = SegmentRegistry[keyof SegmentRegistry];
+    export interface SegmentRegistry {
+        Arc: Arc;
+        Close: Close;
+        CurveTo: CurveTo;
+        CurveSmoothTo: CurveSmoothTo;
+        HorizontalLineTo: HorizontalLineTo;
+        LineTo: LineTo;
+        MoveTo: MoveTo;
+        QuadSmoothTo: QuadSmoothTo;
+        QuadTo: QuadTo;
+        VerticalLineTo: VerticalLineTo;
+    }
+
+}
+
+/* *
+ *
+ *  Default Export
+ *
+ * */
+
+export default SVGPath;

package/es-modules/Core/Renderer/SVG/SVGPath3D.d.ts

@@ -0,0 +1,40 @@
+/* *
+ *
+ *  (c) 2010-2025 Torstein Honsi
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+
+/* *
+ *
+ *  Imports
+ *
+ * */
+
+import type SVGPath from './SVGPath';
+
+/* *
+ *
+ *  Declarations
+ *
+ * */
+
+export interface SVGPath3D {
+    back?: SVGPath;
+    bottom?: SVGPath;
+    front?: SVGPath;
+    side?: SVGPath;
+    top?: SVGPath;
+    zIndexes?: Record<string, number>;
+}
+
+/* *
+ *
+ *  Default Export
+ *
+ * */
+
+export default SVGPath3D;

package/es-modules/Core/Renderer/SVG/SVGRendererBase.d.ts

@@ -0,0 +1,31 @@
+/* *
+ *
+ *  (c) 2010-2025 Torstein Honsi
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+
+/* *
+ *
+ *  Declarations
+ *
+ * */
+
+/**
+ * Optional properties for the SVGElement class. Should be defined outside of
+ * this file by `declare module` pattern.
+ */
+export interface SVGRendererBase {
+    // Nothing here yet
+}
+
+/* *
+ *
+ *  Default Export
+ *
+ * */
+
+export default SVGRendererBase;

package/es-modules/Core/Renderer/SVG/SymbolOptions.d.ts

@@ -0,0 +1,41 @@
+/* *
+ *
+ *  (c) 2010-2025 Torstein Honsi
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+
+/* *
+ *
+ *  Declarations
+ *
+ * */
+
+export interface SymbolOptions {
+    anchorX?: number;
+    anchorY?: number;
+    backgroundSize?: ('contain'|'cover'|'within');
+    context?: 'legend';
+    clockwise?: (0|1);
+    end?: number;
+    height?: number;
+    innerR?: number;
+    longArc?: (0|1);
+    open?: boolean;
+    r?: number;
+    start?: number;
+    width?: number;
+    x?: number;
+    y?: number;
+}
+
+/* *
+ *
+ *  Default Export
+ *
+ * */
+
+export default SymbolOptions;

package/es-modules/Core/Renderer/SVG/SymbolType.d.ts

@@ -0,0 +1,50 @@
+/* *
+ *
+ *  (c) 2010-2025 Torstein Honsi
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+
+/* *
+ *
+ *  Imports
+ *
+ * */
+
+import type SVGPath from './SVGPath';
+import type SymbolOptions from './SymbolOptions';
+
+/* *
+ *
+ *  Declarations
+ *
+ * */
+
+export interface SymbolFunction {
+    (
+        x: number,
+        y: number,
+        width: number,
+        height: number,
+        options?: SymbolOptions
+    ): SVGPath;
+}
+
+export type SymbolKey = keyof SymbolTypeRegistry;
+
+export type SymbolType = SymbolTypeRegistry[SymbolKey];
+
+export interface SymbolTypeRegistry {
+    // Add with declare module pattern
+}
+
+/* *
+ *
+ *  Default Export
+ *
+ * */
+
+export default SymbolType;

package/es-modules/Core/Renderer/ShadowOptionsObject.d.ts

@@ -0,0 +1,40 @@
+/* *
+ *
+ *  (c) 2010-2025 Torstein Honsi
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+
+/* *
+ *
+ *  Imports
+ *
+ * */
+
+import type ColorString from '../Color/ColorString';
+
+/* *
+ *
+ *  Declarations
+ *
+ * */
+
+export interface ShadowOptionsObject {
+    color: ColorString;
+    filterUnits?: string;
+    offsetX: number;
+    offsetY: number;
+    opacity: number;
+    width: number;
+}
+
+/* *
+ *
+ *  Default Export
+ *
+ * */
+
+export default ShadowOptionsObject;

package/es-modules/Core/Renderer/SizeObject.d.ts

@@ -0,0 +1,28 @@
+/* *
+ *
+ *  (c) 2010-2025 Torstein Honsi
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+
+/* *
+ *
+ *  Declarations
+ *
+ * */
+
+export interface SizeObject {
+    height: number;
+    width: number;
+}
+
+/* *
+ *
+ *  Default Export
+ *
+ * */
+
+export default SizeObject;

package/es-modules/Core/Templating.js

@@ -127,12 +127,13 @@ function dateFormat(format, timestamp, upperCaseFirst) {
  *         The formatted string.
  */
 function format(str = '', ctx, owner) {
-    // Notice: using u flag will require a refactor for ES5 (#22450).
-    const regex = /\{([a-zA-Z\u00C0-\u017F\d:\.,;\-\/<>\[\]%_@+"'’= #\(\)]+)\}/g, // eslint-disable-line max-len
+    // eslint-disable-next-line prefer-regex-literals
+    const regex = new RegExp('\\{([\\p{L}\\d:\\.,;\\-\\/<>\\[\\]%_@+"\'’= #\\(\\)]+)\\}', 'gu'), 
     // The sub expression regex is the same as the top expression regex,
     // but except parens and block helpers (#), and surrounded by parens
     // instead of curly brackets.
-    subRegex = /\(([a-zA-Z\u00C0-\u017F\d:\.,;\-\/<>\[\]%_@+"'= ]+)\)/g, matches = [], floatRegex = /f$/, decRegex = /\.(\d)/, lang = owner?.options?.lang || defaultOptions.lang, time = owner?.time || defaultTime, numberFormatter = owner?.numberFormatter || numberFormat.bind(owner);
+    // eslint-disable-next-line prefer-regex-literals
+    subRegex = new RegExp('\\(([\\p{L}\\d:\\.,;\\-\\/<>\\[\\]%_@+"\'= ]+)\\)', 'gu'), matches = [], floatRegex = /f$/, decRegex = /\.(\d)/, lang = owner?.options?.lang || defaultOptions.lang, time = owner?.time || defaultTime, numberFormatter = owner?.numberFormatter || numberFormat.bind(owner);
     /*
      * Get a literal or variable value inside a template expression. May be
      * extended with other types like string or null if needed, but keep it
@@ -267,11 +268,9 @@ function format(str = '', ctx, owner) {
                 [expression] : expression.split(':');
             replacement = resolveProperty(valueAndFormat.shift() || '');
             // Format the replacement
-            const isFloat = replacement % 1 !== 0;
-            if (typeof replacement === 'number' &&
-                (valueAndFormat.length || isFloat)) {
+            if (valueAndFormat.length && typeof replacement === 'number') {
                 const segment = valueAndFormat.join(':');
-                if (floatRegex.test(segment) || isFloat) { // Float
+                if (floatRegex.test(segment)) { // Float
                     const decimals = parseInt((segment.match(decRegex) || ['', '-1'])[1], 10);
                     if (replacement !== null) {
                         replacement = numberFormatter(replacement, decimals, lang.decimalPoint, segment.indexOf(',') > -1 ? lang.thousandsSep : '');

package/es-modules/Data/Connectors/DataConnector.js

@@ -62,7 +62,7 @@ class DataConnector {
         let dataTableIndex = 0;
         if (options.options) {
             // eslint-disable-next-line no-console
-            console.error('The `DataConnectorOptions.options` property was removed in Dashboards v4.0.0. Check how to upgrade your connector to use the new options structure here: https://api.highcharts.com/dashboards/#interfaces/Data_DataTableOptions.DataTableOptions-1');
+            console.error('The `DataConnectorOptions.options` property was removed in Dashboards v4.0.0. Check how to upgrade your connector to use the new options structure here: https://api.highcharts.com/dashboards/#interfaces/Data_DataTableOptions.DataTableOptions');
         }
         if (dataTables && dataTables?.length > 0) {
             for (let i = 0, iEnd = dataTables.length; i < iEnd; ++i) {
@@ -74,9 +74,10 @@ class DataConnector {
                     dataTableIndex++;
                 }
             }
-            // If user options dataTables is not defined, generate a default table.
         }
         else {
+            // If user options dataTables is not defined, generate a default
+            // table.
             this.dataTables[0] = new DataTable({
                 id: options.id // Required by DataTableCore
             });

package/es-modules/Data/Connectors/DataConnectorOptions.d.ts

@@ -45,7 +45,7 @@ export interface DataConnectorOptions {
      * @deprecated
      * Removed in Dashboards v4.0.0
      *
-     * {@link https://api.highcharts.com/dashboards/#interfaces/Data_Connectors_DataConnectorOptions.DataConnectorOptions-1 | Check how to upgrade your connector to use the new options structure}
+     * {@link https://api.highcharts.com/dashboards/#interfaces/Data_Connectors_DataConnectorOptions.DataConnectorOptions | Check how to upgrade your connector to use the new options structure}
      */
     options?: never;
 }

package/es-modules/Data/DataTable.d.ts

@@ -431,7 +431,7 @@ declare class DataTable extends DataTableCore implements DataEvent.Emitter<DataT
      * Cell values to set.
      *
      * @param {number} [rowIndex]
-     * Index of the row to set. Leave `undefind` to add as a new row.
+     * Index of the row to set. Leave `undefined` to add as a new row.
      *
      * @param {boolean} [insert]
      * Whether to insert the row at the given index, or to overwrite the row.

package/es-modules/Data/DataTable.js

@@ -84,6 +84,7 @@ class DataTable extends DataTableCore {
             tableClone.originalRowIndexes = table.originalRowIndexes;
             tableClone.localRowIndexes = table.localRowIndexes;
         }
+        tableClone.metadata = { ...table.metadata };
         table.emit({
             type: 'afterCloneTable',
             detail: eventDetail,
@@ -833,7 +834,7 @@ class DataTable extends DataTableCore {
      * Cell values to set.
      *
      * @param {number} [rowIndex]
-     * Index of the row to set. Leave `undefind` to add as a new row.
+     * Index of the row to set. Leave `undefined` to add as a new row.
      *
      * @param {boolean} [insert]
      * Whether to insert the row at the given index, or to overwrite the row.
@@ -897,7 +898,7 @@ class DataTable extends DataTableCore {
                 }
             }
             else {
-                super.setRow(row, i2, void 0, { silent: true });
+                super.setRow(row, i2, insert, { silent: true });
             }
         }
         const indexRowCount = insert ?

package/es-modules/Data/DataTableCore.js

@@ -242,16 +242,25 @@ class DataTableCore {
      * @emits #afterSetRows
      */
     setRow(row, rowIndex = this.rowCount, insert, eventDetail) {
-        const { columns } = this, indexRowCount = insert ? this.rowCount + 1 : rowIndex + 1;
-        objectEach(row, (cellValue, columnId) => {
-            let column = columns[columnId] ||
-                eventDetail?.addColumns !== false && new Array(indexRowCount);
+        const { columns } = this, indexRowCount = insert ? this.rowCount + 1 : rowIndex + 1, rowKeys = Object.keys(row);
+        if (eventDetail?.addColumns !== false) {
+            for (let i = 0, iEnd = rowKeys.length; i < iEnd; i++) {
+                const key = rowKeys[i];
+                if (!columns[key]) {
+                    columns[key] = [];
+                }
+            }
+        }
+        objectEach(columns, (column, columnId) => {
+            if (!column && eventDetail?.addColumns !== false) {
+                column = new Array(indexRowCount);
+            }
             if (column) {
                 if (insert) {
-                    column = splice(column, rowIndex, 0, true, [cellValue]).array;
+                    column = splice(column, rowIndex, 0, true, [row[columnId] ?? null]).array;
                 }
                 else {
-                    column[rowIndex] = cellValue;
+                    column[rowIndex] = row[columnId] ?? null;
                 }
                 columns[columnId] = column;
             }

package/es-modules/Grid/Core/Accessibility/Accessibility.d.ts

@@ -64,7 +64,7 @@ declare class Accessibility {
      * @param state
      * The sort state to be set for the column header cell.
      */
-    setColumnSortState(thElement: HTMLElement, state: Accessibility.AriaSortState): void;
+    setColumnSortState(thElement: HTMLElement, state: AriaSortState): void;
     /**
      * Announce the message to the screen reader that the user filtered the
      * column.
@@ -75,7 +75,7 @@ declare class Accessibility {
      * @param filteringApplied
      * Whether the filtering was applied or cleared.
      */
-    userFilteredColumn(filteredColumnValues: Accessibility.FilteredColumnValues, filteringApplied: boolean): void;
+    userFilteredColumn(filteredColumnValues: FilteredColumnValues, filteringApplied: boolean): void;
     /**
      * Adds high contrast CSS class, if the browser is in High Contrast mode.
      */
@@ -99,17 +99,15 @@ declare class Accessibility {
      */
     destroy(): void;
 }
-declare namespace Accessibility {
-    /**
-     * The possible states of the aria-sort attribute.
-     */
-    type AriaSortState = 'ascending' | 'descending' | 'none';
-    /**
-     * The values of the filtered column.
-     */
-    type FilteredColumnValues = FilteringCondition & {
-        columnId: string;
-        rowsCount: number;
-    };
-}
+/**
+ * The possible states of the aria-sort attribute.
+ */
+export type AriaSortState = 'ascending' | 'descending' | 'none';
+/**
+ * The values of the filtered column.
+ */
+export type FilteredColumnValues = FilteringCondition & {
+    columnId: string;
+    rowsCount: number;
+};
 export default Accessibility;

package/es-modules/Grid/Core/Credits.d.ts

@@ -52,6 +52,4 @@ declare class Credits {
      */
     destroy(): void;
 }
-declare namespace Credits {
-}
 export default Credits;

package/es-modules/Grid/Core/Defaults.d.ts

@@ -1,20 +1,23 @@
-import type Options from './Options';
+import type { Options, LangOptions } from './Options';
 import type { DeepPartial } from '../../Shared/Types';
 /**
- * Namespace for default options.
+ * Default language options for the Grid.
  */
-declare namespace Defaults {
-    /**
-     * Default options for the Grid.
-     */
-    const defaultOptions: DeepPartial<Options>;
-    /**
-     * Merge the default options with custom options. Commonly used for defining
-     * reusable templates.
-     *
-     * @param options
-     * The new custom chart options.
-     */
-    function setOptions(options: DeepPartial<Options>): void;
-}
-export default Defaults;
+export declare const defaultLangOptions: DeepPartial<LangOptions>;
+/**
+ * Default options for the Grid.
+ */
+export declare const defaultOptions: DeepPartial<Options>;
+/**
+ * Merge the default options with custom options. Commonly used for defining
+ * reusable templates.
+ *
+ * @param options
+ * The new custom grid options.
+ */
+export declare function setOptions(options: DeepPartial<Options>): void;
+declare const _default: {
+    readonly defaultOptions: DeepPartial<Options>;
+    readonly setOptions: typeof setOptions;
+};
+export default _default;