@highcharts/grid-pro 2.1.1 → 2.3.0

package/es-modules/Data/Converters/DataConverterUtils.js

@@ -1,216 +1,204 @@
 /* *
  *
- *  (c) 2009-2025 Highsoft AS
+ *  (c) 2009-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. !!!!!!!
  *
  *  Authors:
  *  - Kamil Kubik
  *
  * */
-import U from '../../Core/Utilities.js';
-const { isNumber } = U;
+import { isNumber } from '../../Shared/Utilities.js';
 /* *
  *
- *  Namespace
+ *  Functions
  *
  * */
-var DataConverterUtils;
-(function (DataConverterUtils) {
-    /* *
-    *
-    *  Properties
-    *
-    * */
-    /* *
-    *
-    * Functions
-    *
-    * */
-    /**
-     * Converts a value to a Date.
-     *
-     * @param {DataConverter.Type} value
-     * Value to convert.
-     *
-     * @return {globalThis.Date}
-     * Converted value as a Date.
-     */
-    function asDate(value, converter) {
-        let timestamp;
-        if (typeof value === 'string') {
-            timestamp = converter.parseDate(value);
-        }
-        else if (typeof value === 'number') {
-            timestamp = value;
-        }
-        else if (value instanceof Date) {
-            return value;
-        }
-        else {
-            timestamp = converter.parseDate(asString(value));
-        }
-        return new Date(timestamp);
+/**
+ * Converts a value to a Date.
+ *
+ * @param {DataConverterType} value
+ * Value to convert.
+ *
+ * @return {globalThis.Date}
+ * Converted value as a Date.
+ */
+export function asDate(value, converter) {
+    let timestamp;
+    if (typeof value === 'string') {
+        timestamp = converter.parseDate(value);
     }
-    DataConverterUtils.asDate = asDate;
-    /**
-     * Converts a value to a number.
-     *
-     * @param {DataConverter.Type} value
-     * Value to convert.
-     *
-     * @return {number}
-     * Converted value as a number.
-     */
-    function asNumber(value, decimalRegExp) {
-        if (typeof value === 'number') {
-            return value;
-        }
-        if (typeof value === 'boolean') {
-            return value ? 1 : 0;
+    else if (typeof value === 'number') {
+        timestamp = value;
+    }
+    else if (value instanceof Date) {
+        return value;
+    }
+    else {
+        timestamp = converter.parseDate(asString(value));
+    }
+    return new Date(timestamp);
+}
+/**
+ * Converts a value to a number.
+ *
+ * @param {DataConverterType} value
+ * Value to convert.
+ *
+ * @return {number}
+ * Converted value as a number.
+ */
+export function asNumber(value, decimalRegExp) {
+    if (typeof value === 'number') {
+        return value;
+    }
+    if (typeof value === 'boolean') {
+        return value ? 1 : 0;
+    }
+    if (typeof value === 'string') {
+        const decimalRegex = decimalRegExp;
+        if (value.indexOf(' ') > -1) {
+            value = value.replace(/\s+/g, '');
         }
-        if (typeof value === 'string') {
-            const decimalRegex = decimalRegExp;
-            if (value.indexOf(' ') > -1) {
-                value = value.replace(/\s+/g, '');
-            }
-            if (decimalRegex) {
-                if (!decimalRegex.test(value)) {
-                    return NaN;
-                }
-                value = value.replace(decimalRegex, '$1.$2');
+        if (decimalRegex) {
+            if (!decimalRegex.test(value)) {
+                return NaN;
             }
-            return parseFloat(value);
+            value = value.replace(decimalRegex, '$1.$2');
         }
-        if (value instanceof Date) {
-            return value.getDate();
-        }
-        if (value) {
-            return value.getRowCount();
-        }
-        return NaN;
+        return parseFloat(value);
     }
-    DataConverterUtils.asNumber = asNumber;
-    /**
-     * Converts a value to a string.
-     *
-     * @param {DataConverter.Type} value
-     * Value to convert.
-     *
-     * @return {string}
-     * Converted value as a string.
-     */
-    function asString(value) {
-        return '' + value;
+    if (value instanceof Date) {
+        return value.getDate();
     }
-    DataConverterUtils.asString = asString;
-    /**
-     * Converts a value to a boolean.
-     *
-     * @param {DataConverter.Type} value
-     * Value to convert.
-     *
-     * @return {boolean}
-     * Converted value as a boolean.
-     */
-    function asBoolean(value) {
-        if (typeof value === 'boolean') {
-            return value;
-        }
-        if (typeof value === 'string') {
-            return value !== '' && value !== '0' && value !== 'false';
-        }
-        return !!asNumber(value);
+    if (value) {
+        return value.getRowCount();
     }
-    DataConverterUtils.asBoolean = asBoolean;
-    /**
-     * Guesses the potential type of a string value for parsing CSV etc.
-     *
-     * @param {*} value
-     * The value to examine.
-     *
-     * @return {'number' | 'string' | 'Date'}
-     * Type string, either `string`, `Date`, or `number`.
-     */
-    function guessType(value, converter) {
-        let result = 'string';
-        if (typeof value === 'string') {
-            const trimedValue = DataConverterUtils.trim(`${value}`), decimalRegExp = converter.decimalRegExp;
-            let innerTrimedValue = DataConverterUtils.trim(trimedValue, true);
-            if (decimalRegExp) {
-                innerTrimedValue = (decimalRegExp.test(innerTrimedValue) ?
-                    innerTrimedValue.replace(decimalRegExp, '$1.$2') :
-                    '');
-            }
-            const floatValue = parseFloat(innerTrimedValue);
-            if (+innerTrimedValue === floatValue) {
-                // String is numeric
-                value = floatValue;
-            }
-            else {
-                // Determine if a date string
-                const dateValue = converter.parseDate(value);
-                result = isNumber(dateValue) ? 'Date' : 'string';
-            }
+    return NaN;
+}
+/**
+ * Converts a value to a string.
+ *
+ * @param {DataConverterType} value
+ * Value to convert.
+ *
+ * @return {string}
+ * Converted value as a string.
+ */
+export function asString(value) {
+    return '' + value;
+}
+/**
+ * Converts a value to a boolean.
+ *
+ * @param {DataConverterType} value
+ * Value to convert.
+ *
+ * @return {boolean}
+ * Converted value as a boolean.
+ */
+export function asBoolean(value) {
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    if (typeof value === 'string') {
+        return value !== '' && value !== '0' && value !== 'false';
+    }
+    return !!asNumber(value);
+}
+/**
+ * Guesses the potential type of a string value for parsing CSV etc.
+ *
+ * @param {*} value
+ * The value to examine.
+ *
+ * @return {'number' | 'string' | 'Date'}
+ * Type string, either `string`, `Date`, or `number`.
+ */
+export function guessType(value, converter) {
+    let result = 'string';
+    if (typeof value === 'string') {
+        const trimedValue = trim(`${value}`), decimalRegExp = converter.decimalRegExp;
+        let innerTrimedValue = trim(trimedValue, true);
+        if (decimalRegExp) {
+            innerTrimedValue = (decimalRegExp.test(innerTrimedValue) ?
+                innerTrimedValue.replace(decimalRegExp, '$1.$2') :
+                '');
         }
-        if (typeof value === 'number') {
-            // Greater than milliseconds in a year assumed timestamp
-            result = value > 365 * 24 * 3600 * 1000 ? 'Date' : 'number';
+        const floatValue = parseFloat(innerTrimedValue);
+        if (+innerTrimedValue === floatValue) {
+            // String is numeric
+            value = floatValue;
         }
-        return result;
-    }
-    DataConverterUtils.guessType = guessType;
-    /**
-     * Trim a string from whitespaces.
-     *
-     * @param {string} str
-     * String to trim.
-     *
-     * @param {boolean} [inside=false]
-     * Remove all spaces between numbers.
-     *
-     * @return {string}
-     * Trimed string
-     */
-    function trim(str, inside) {
-        if (typeof str === 'string') {
-            str = str.replace(/^\s+|\s+$/g, '');
-            // Clear white space insdie the string, like thousands separators
-            if (inside && /^[\d\s]+$/.test(str)) {
-                str = str.replace(/\s/g, '');
-            }
+        else {
+            // Determine if a date string
+            const dateValue = converter.parseDate(value);
+            result = isNumber(dateValue) ? 'Date' : 'string';
         }
-        return str;
     }
-    DataConverterUtils.trim = trim;
-    /**
-     * Parses an array of columns to a column collection. If more headers are
-     * provided, the corresponding, empty columns are added.
-     *
-     * @param {DataTable.Column[]} [columnsArray]
-     * Array of columns.
-     *
-     * @param {string[]} [headers]
-     * Column ids to use.
-     *
-     * @return {DataTable.ColumnCollection}
-     * Parsed columns.
-     */
-    function getColumnsCollection(columnsArray = [], headers) {
-        const columns = {};
-        for (let i = 0, iEnd = Math.max(headers.length, columnsArray.length); i < iEnd; ++i) {
-            const columnId = headers[i] || `${i}`;
-            columns[columnId] = columnsArray[i] ? columnsArray[i].slice() : [];
+    if (typeof value === 'number') {
+        // Greater than milliseconds in a year assumed timestamp
+        result = value > 365 * 24 * 3600 * 1000 ? 'Date' : 'number';
+    }
+    return result;
+}
+/**
+ * Trim a string from whitespaces.
+ *
+ * @param {string} str
+ * String to trim.
+ *
+ * @param {boolean} [inside=false]
+ * Remove all spaces between numbers.
+ *
+ * @return {string}
+ * Trimed string
+ */
+export function trim(str, inside) {
+    if (typeof str === 'string') {
+        str = str.replace(/^\s+|\s+$/g, '');
+        // Clear white space insdie the string, like thousands separators
+        if (inside && /^[\d\s]+$/.test(str)) {
+            str = str.replace(/\s/g, '');
         }
-        return columns;
     }
-    DataConverterUtils.getColumnsCollection = getColumnsCollection;
-})(DataConverterUtils || (DataConverterUtils = {}));
+    return str;
+}
+/**
+ * Parses an array of columns to a column collection. If more headers are
+ * provided, the corresponding, empty columns are added.
+ *
+ * @param {DataTableColumn[]} [columnsArray]
+ * Array of columns.
+ *
+ * @param {string[]} [headers]
+ * Column ids to use.
+ *
+ * @return {DataTableColumnCollection}
+ * Parsed columns.
+ */
+export function getColumnsCollection(columnsArray = [], headers) {
+    const columns = {};
+    for (let i = 0, iEnd = Math.max(headers.length, columnsArray.length); i < iEnd; ++i) {
+        const columnId = headers[i] || `${i}`;
+        columns[columnId] = columnsArray[i] ? columnsArray[i].slice() : [];
+    }
+    return columns;
+}
 /* *
  *
  *  Default Export
  *
  * */
+const DataConverterUtils = {
+    asBoolean,
+    asDate,
+    asNumber,
+    asString,
+    getColumnsCollection,
+    guessType,
+    trim
+};
 export default DataConverterUtils;

package/es-modules/Data/Converters/GoogleSheetsConverter.d.ts

@@ -1,7 +1,7 @@
-import type DataEvent from '../DataEvent';
+import type { DataEventDetail } from '../DataEvent';
 import type GoogleSheetsConverterOptions from './GoogleSheetsConverterOptions';
 import DataConverter from './DataConverter.js';
-import DataTable from '../DataTable.js';
+import type { ColumnCollection as DataTableColumnCollection } from '../DataTable.js';
 /**
  * Handles parsing and transformation of an Google Sheets to a table.
  *
@@ -30,13 +30,13 @@ declare class GoogleSheetsConverter extends DataConverter {
      * @param {Partial<GoogleSheetsConverterOptions>}[options]
      * Options for the parser
      *
-     * @param {DataEvent.Detail} [eventDetail]
+     * @param {DataEventDetail} [eventDetail]
      * Custom information for pending events.
      *
      * @emits GoogleSheetsParser#parse
      * @emits GoogleSheetsParser#afterParse
      */
-    parse(options: Partial<GoogleSheetsConverterOptions>, eventDetail?: DataEvent.Detail): DataTable.ColumnCollection;
+    parse(options: Partial<GoogleSheetsConverterOptions>, eventDetail?: DataEventDetail): DataTableColumnCollection;
 }
 declare module './DataConverterType' {
     interface DataConverterTypes {

package/es-modules/Data/Converters/GoogleSheetsConverter.js

@@ -1,10 +1,10 @@
 /* *
  *
- *  (c) 2009-2025 Highsoft AS
+ *  (c) 2009-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. !!!!!!!
  *
  *  Authors:
  *  - Torstein Hønsi
@@ -17,8 +17,8 @@
 'use strict';
 import DataConverter from './DataConverter.js';
 import DataConverterUtils from './DataConverterUtils.js';
-import U from '../../Core/Utilities.js';
-const { merge, uniqueKey } = U;
+import { merge } from '../../Shared/Utilities.js';
+import { uniqueKey } from '../../Core/Utilities.js';
 /* *
  *
  *  Class
@@ -58,7 +58,7 @@ class GoogleSheetsConverter extends DataConverter {
      * @param {Partial<GoogleSheetsConverterOptions>}[options]
      * Options for the parser
      *
-     * @param {DataEvent.Detail} [eventDetail]
+     * @param {DataEventDetail} [eventDetail]
      * Custom information for pending events.
      *
      * @emits GoogleSheetsParser#parse

package/es-modules/Data/Converters/GoogleSheetsConverterOptions.d.ts

@@ -1,10 +1,10 @@
 /* *
  *
- *  (c) 2009-2025 Highsoft AS
+ *  (c) 2009-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. !!!!!!!
  *
  *  Authors:
  *  - Kamil Kubik
@@ -19,7 +19,7 @@
 
 import type { GoogleSheetsBeforeParseCallbackFunction } from '../Connectors/GoogleSheetsConnectorOptions';
 
-import DataConverter from './DataConverter';
+import type { Options as DataConverterOptions } from './DataConverter';
 
 /* *
  *
@@ -30,7 +30,7 @@ import DataConverter from './DataConverter';
 /**
  * Options of the GoogleSheetsConverter.
  */
-export interface GoogleSheetsConverterOptions extends DataConverter.Options {
+export interface GoogleSheetsConverterOptions extends DataConverterOptions {
     json?: GoogleSpreadsheetJSON;
     beforeParse?: GoogleSheetsBeforeParseCallbackFunction;
 }

package/es-modules/Data/Converters/HTMLTableConverter.d.ts

@@ -1,8 +1,8 @@
-import type DataEvent from '../DataEvent';
+import type { DataEventDetail } from '../DataEvent';
 import type DataConnector from '../Connectors/DataConnector';
 import type HTMLTableConverterOptions from './HTMLTableConverterOptions';
 import DataConverter from './DataConverter.js';
-import DataTable from '../DataTable.js';
+import type { ColumnCollection as DataTableColumnCollection } from '../DataTable.js';
 /**
  * Handles parsing and transformation of an HTML table to a table.
  *
@@ -55,14 +55,14 @@ declare class HTMLTableConverter extends DataConverter {
      * @param {Partial<HTMLTableConverterOptions>}[options]
      * Options for the parser
      *
-     * @param {DataEvent.Detail} [eventDetail]
+     * @param {DataEventDetail} [eventDetail]
      * Custom information for pending events.
      *
      * @emits CSVDataParser#parse
      * @emits CSVDataParser#afterParse
      * @emits HTMLTableParser#parseError
      */
-    parse(options: Partial<HTMLTableConverterOptions>, eventDetail?: DataEvent.Detail): DataTable.ColumnCollection;
+    parse(options: Partial<HTMLTableConverterOptions>, eventDetail?: DataEventDetail): DataTableColumnCollection;
 }
 declare module './DataConverterType' {
     interface DataConverterTypes {

package/es-modules/Data/Converters/HTMLTableConverter.js

@@ -1,10 +1,10 @@
 /* *
  *
- *  (c) 2009-2025 Highsoft AS
+ *  (c) 2009-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. !!!!!!!
  *
  *  Authors:
  *  - Torstein Hønsi
@@ -17,8 +17,7 @@
 'use strict';
 import DataConverter from './DataConverter.js';
 import DataConverterUtils from './DataConverterUtils.js';
-import U from '../../Core/Utilities.js';
-const { merge } = U;
+import { merge } from '../../Shared/Utilities.js';
 /* *
  *
  *  Functions
@@ -249,7 +248,7 @@ class HTMLTableConverter extends DataConverter {
      * @param {Partial<HTMLTableConverterOptions>}[options]
      * Options for the parser
      *
-     * @param {DataEvent.Detail} [eventDetail]
+     * @param {DataEventDetail} [eventDetail]
      * Custom information for pending events.
      *
      * @emits CSVDataParser#parse

package/es-modules/Data/Converters/HTMLTableConverterOptions.d.ts

@@ -1,10 +1,10 @@
 /* *
  *
- *  (c) 2009-2025 Highsoft AS
+ *  (c) 2009-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. !!!!!!!
  *
  *  Authors:
  *  - Kamil Kubik
@@ -17,7 +17,7 @@
  *
  * */
 
-import DataConverter from './DataConverter';
+import type { Options as DataConverterOptions } from './DataConverter';
 
 /* *
  *
@@ -28,7 +28,7 @@ import DataConverter from './DataConverter';
 /**
  * Options of the HTMLTableConverter.
  */
-export interface HTMLTableConverterOptions extends DataConverter.Options {
+export interface HTMLTableConverterOptions extends DataConverterOptions {
     startRow: number;
     endRow: number;
     startColumn: number;

package/es-modules/Data/Converters/JSONConverter.d.ts

@@ -1,7 +1,7 @@
-import type DataEvent from '../DataEvent';
+import type { DataEventDetail } from '../DataEvent';
 import type JSONConverterOptions from './JSONConverterOptions';
 import DataConverter from './DataConverter.js';
-import DataTable from '../DataTable.js';
+import type { ColumnCollection as DataTableColumnCollection } from '../DataTable.js';
 /**
  * Handles parsing and transforming JSON to a table.
  *
@@ -31,17 +31,17 @@ declare class JSONConverter extends DataConverter {
      * @param {Partial<JSONConverterOptions>}[options]
      * Options for the parser
      *
-     * @param {DataEvent.Detail} [eventDetail]
+     * @param {DataEventDetail} [eventDetail]
      * Custom information for pending events.
      *
      * @emits JSONConverter#parse
      * @emits JSONConverter#afterParse
      */
-    parse(options: Partial<JSONConverterOptions>, eventDetail?: DataEvent.Detail): DataTable.ColumnCollection;
+    parse(options: Partial<JSONConverterOptions>, eventDetail?: DataEventDetail): DataTableColumnCollection;
     /**
      * Helper for parsing data in 'columns' orientation.
      *
-     * @param {DataTable.BasicColumn[]} [columnsArray]
+     * @param {DataTableBasicColumn[]} [columnsArray]
      * Array of columns.
      *
      * @param {unknown[]} [data]
@@ -59,7 +59,7 @@ declare class JSONConverter extends DataConverter {
     /**
      * Helper for parsing data in 'rows' orientation.
      *
-     * @param {DataTable.BasicColumn[]} [columnsArray]
+     * @param {DataTableBasicColumn[]} [columnsArray]
      * Array of columns.
      *
      * Helper for parsing data in 'rows' orientation.
@@ -73,7 +73,7 @@ declare class JSONConverter extends DataConverter {
      * @param {Array<string>} [columnIds]
      * Column ids to retrieve.
      *
-     * @return {DataTable.BasicColumn[]}
+     * @return {DataTableBasicColumn[]}
      * Parsed columns.
      */
     private parseRowsOrientation;