@highcharts/grid-pro 2.0.0

package/es-modules/Data/Formula/FormulaTypes.js

@@ -0,0 +1,135 @@
+/* *
+ *
+ *  (c) 2009-2025 Highsoft AS
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ *  Authors:
+ *  - Sophie Bremer
+ *
+ * */
+'use strict';
+/* *
+ *
+ *  Constants
+ *
+ * */
+/**
+ * Array of all possible operators.
+ * @private
+ */
+const operators = ['+', '-', '*', '/', '^', '=', '<', '<=', '>', '>='];
+/* *
+ *
+ *  Functions
+ *
+ * */
+/**
+ * Tests an item for a Formula array.
+ *
+ * @private
+ *
+ * @param {Highcharts.FormulaItem} item
+ * Item to test.
+ *
+ * @return {boolean}
+ * `true`, if the item is a formula (or argument) array.
+ */
+function isFormula(item) {
+    return Array.isArray(item);
+}
+/**
+ * Tests an item for a Function structure.
+ *
+ * @private
+ *
+ * @param {Highcharts.FormulaItem} item
+ * Item to test.
+ *
+ * @return {boolean}
+ * `true`, if the item is a formula function.
+ */
+function isFunction(item) {
+    return (typeof item === 'object' &&
+        !(Array.isArray(item)) &&
+        item.type === 'function');
+}
+/**
+ * Tests an item for an Operator string.
+ *
+ * @private
+ *
+ * @param {Highcharts.FormulaItem} item
+ * Item to test.
+ *
+ * @return {boolean}
+ * `true`, if the item is an operator string.
+ */
+function isOperator(item) {
+    return (typeof item === 'string' &&
+        operators.indexOf(item) >= 0);
+}
+/**
+ * Tests an item for a Range structure.
+ *
+ * @private
+ *
+ * @param {Highcharts.FormulaItem} item
+ * Item to test.
+ *
+ * @return {boolean}
+ * `true`, if the item is a range.
+ */
+function isRange(item) {
+    return (typeof item === 'object' &&
+        !(Array.isArray(item)) &&
+        item.type === 'range');
+}
+/**
+ * Tests an item for a Reference structure.
+ *
+ * @private
+ *
+ * @param {Highcharts.FormulaItem} item
+ * Item to test.
+ *
+ * @return {boolean}
+ * `true`, if the item is a reference.
+ */
+function isReference(item) {
+    return (typeof item === 'object' &&
+        !(Array.isArray(item)) &&
+        item.type === 'reference');
+}
+/**
+ * Tests an item for a Value structure.
+ *
+ * @private
+ *
+ * @param {Highcharts.FormulaItem|null|undefined} item
+ * Item to test.
+ *
+ * @return {boolean}
+ * `true`, if the item is a value.
+ */
+function isValue(item) {
+    return (typeof item === 'boolean' ||
+        typeof item === 'number' ||
+        typeof item === 'string');
+}
+/* *
+ *
+ *  Default Export
+ *
+ * */
+const MathFormula = {
+    isFormula,
+    isFunction,
+    isOperator,
+    isRange,
+    isReference,
+    isValue
+};
+export default MathFormula;

package/es-modules/Data/Formula/Functions/ABS.d.ts

@@ -0,0 +1,19 @@
+import type { Arguments } from '../FormulaTypes';
+import type DataTable from '../../DataTable';
+/**
+ * Processor for the `ABS(value)` implementation. Returns positive numbers.
+ *
+ * @private
+ * @function Formula.processorFunctions.AND
+ *
+ * @param {Highcharts.FormulaArguments} args
+ * Arguments to process.
+ *
+ * @param {Highcharts.DataTable} [table]
+ * Table to use for references and ranges.
+ *
+ * @return {Array<number>}
+ * Result value of the process.
+ */
+declare function ABS(args: Arguments, table?: DataTable): (number | Array<number>);
+export default ABS;

package/es-modules/Data/Formula/Functions/ABS.js

@@ -0,0 +1,67 @@
+/* *
+ *
+ *  (c) 2009-2025 Highsoft AS
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ *  Authors:
+ *  - Sophie Bremer
+ *
+ * */
+'use strict';
+import FormulaProcessor from '../FormulaProcessor.js';
+const { getArgumentValue } = FormulaProcessor;
+/* *
+ *
+ *  Functions
+ *
+ * */
+/**
+ * Processor for the `ABS(value)` implementation. Returns positive numbers.
+ *
+ * @private
+ * @function Formula.processorFunctions.AND
+ *
+ * @param {Highcharts.FormulaArguments} args
+ * Arguments to process.
+ *
+ * @param {Highcharts.DataTable} [table]
+ * Table to use for references and ranges.
+ *
+ * @return {Array<number>}
+ * Result value of the process.
+ */
+function ABS(args, table) {
+    const value = getArgumentValue(args[0], table);
+    switch (typeof value) {
+        case 'number':
+            return Math.abs(value);
+        case 'object': {
+            const values = [];
+            for (let i = 0, iEnd = value.length, value2; i < iEnd; ++i) {
+                value2 = value[i];
+                if (typeof value2 !== 'number') {
+                    return NaN;
+                }
+                values.push(Math.abs(value2));
+            }
+            return values;
+        }
+        default:
+            return NaN;
+    }
+}
+/* *
+ *
+ *  Registry
+ *
+ * */
+FormulaProcessor.registerProcessorFunction('ABS', ABS);
+/* *
+ *
+ *  Default Export
+ *
+ * */
+export default ABS;

package/es-modules/Data/Formula/Functions/AND.d.ts

@@ -0,0 +1,20 @@
+import type { Arguments } from '../FormulaTypes';
+import type DataTable from '../../DataTable';
+/**
+ * Processor for the `AND(...tests)` implementation. Returns `TRUE`, if all test
+ * results are not `0` or `FALSE`.
+ *
+ * @private
+ * @function Formula.processorFunctions.AND
+ *
+ * @param {Highcharts.FormulaArguments} args
+ * Arguments to process.
+ *
+ * @param {Highcharts.DataTable} [table]
+ * Table to use for references and ranges.
+ *
+ * @return {boolean}
+ * Result value of the process.
+ */
+declare function AND(args: Arguments, table?: DataTable): boolean;
+export default AND;

package/es-modules/Data/Formula/Functions/AND.js

@@ -0,0 +1,59 @@
+/* *
+ *
+ *  (c) 2009-2025 Highsoft AS
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ *  Authors:
+ *  - Sophie Bremer
+ *
+ * */
+'use strict';
+import FormulaProcessor from '../FormulaProcessor.js';
+const { getArgumentValue } = FormulaProcessor;
+/* *
+ *
+ *  Functions
+ *
+ * */
+/**
+ * Processor for the `AND(...tests)` implementation. Returns `TRUE`, if all test
+ * results are not `0` or `FALSE`.
+ *
+ * @private
+ * @function Formula.processorFunctions.AND
+ *
+ * @param {Highcharts.FormulaArguments} args
+ * Arguments to process.
+ *
+ * @param {Highcharts.DataTable} [table]
+ * Table to use for references and ranges.
+ *
+ * @return {boolean}
+ * Result value of the process.
+ */
+function AND(args, table) {
+    for (let i = 0, iEnd = args.length, value; i < iEnd; ++i) {
+        value = getArgumentValue(args[i], table);
+        if (!value ||
+            (typeof value === 'object' &&
+                !AND(value, table))) {
+            return false;
+        }
+    }
+    return true;
+}
+/* *
+ *
+ *  Registry
+ *
+ * */
+FormulaProcessor.registerProcessorFunction('AND', AND);
+/* *
+ *
+ *  Default Export
+ *
+ * */
+export default AND;

package/es-modules/Data/Formula/Functions/AVERAGE.d.ts

@@ -0,0 +1,20 @@
+import type { Arguments } from '../FormulaTypes';
+import type DataTable from '../../DataTable';
+/**
+ * Processor for the `AVERAGE(...values)` implementation. Calculates the average
+ * of the given values that are numbers.
+ *
+ * @private
+ * @function Formula.processorFunctions.AVERAGE
+ *
+ * @param {Highcharts.FormulaArguments} args
+ * Arguments to process.
+ *
+ * @param {Highcharts.DataTable} [table]
+ * Table to use for references and ranges.
+ *
+ * @return {number}
+ * Result value of the process.
+ */
+declare function AVERAGE(args: Arguments, table?: DataTable): number;
+export default AVERAGE;

package/es-modules/Data/Formula/Functions/AVERAGE.js

@@ -0,0 +1,74 @@
+/* *
+ *
+ *  (c) 2009-2025 Highsoft AS
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ *  Authors:
+ *  - Sophie Bremer
+ *
+ * */
+'use strict';
+import FormulaProcessor from '../FormulaProcessor.js';
+const { getArgumentsValues } = FormulaProcessor;
+/* *
+ *
+ *  Functions
+ *
+ * */
+/**
+ * Processor for the `AVERAGE(...values)` implementation. Calculates the average
+ * of the given values that are numbers.
+ *
+ * @private
+ * @function Formula.processorFunctions.AVERAGE
+ *
+ * @param {Highcharts.FormulaArguments} args
+ * Arguments to process.
+ *
+ * @param {Highcharts.DataTable} [table]
+ * Table to use for references and ranges.
+ *
+ * @return {number}
+ * Result value of the process.
+ */
+function AVERAGE(args, table) {
+    const values = getArgumentsValues(args, table);
+    let count = 0, result = 0;
+    for (let i = 0, iEnd = values.length, value; i < iEnd; ++i) {
+        value = values[i];
+        switch (typeof value) {
+            case 'number':
+                if (!isNaN(value)) {
+                    ++count;
+                    result += value;
+                }
+                break;
+            case 'object':
+                for (let j = 0, jEnd = value.length, value2; j < jEnd; ++j) {
+                    value2 = value[j];
+                    if (typeof value2 === 'number' &&
+                        !isNaN(value2)) {
+                        ++count;
+                        result += value2;
+                    }
+                }
+                break;
+        }
+    }
+    return (count ? (result / count) : 0);
+}
+/* *
+ *
+ *  Registry
+ *
+ * */
+FormulaProcessor.registerProcessorFunction('AVERAGE', AVERAGE);
+/* *
+ *
+ *  Default Export
+ *
+ * */
+export default AVERAGE;

package/es-modules/Data/Formula/Functions/AVERAGEA.d.ts

@@ -0,0 +1,20 @@
+import type { Arguments } from '../FormulaTypes';
+import type DataTable from '../../DataTable';
+/**
+ * Processor for the `AVERAGEA(...values)` implementation. Calculates the
+ * average of the given values. Strings and FALSE are calculated as 0.
+ *
+ * @private
+ * @function Formula.processorFunctions.AVERAGEA
+ *
+ * @param {Highcharts.FormulaArguments} args
+ * Arguments to process.
+ *
+ * @param {Highcharts.DataTable} [table]
+ * Table to use for references and ranges.
+ *
+ * @return {number}
+ * Result value of the process.
+ */
+declare function AVERAGEA(args: Arguments, table?: DataTable): number;
+export default AVERAGEA;

package/es-modules/Data/Formula/Functions/AVERAGEA.js

@@ -0,0 +1,90 @@
+/* *
+ *
+ *  (c) 2009-2025 Highsoft AS
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ *  Authors:
+ *  - Sophie Bremer
+ *
+ * */
+'use strict';
+import FormulaProcessor from '../FormulaProcessor.js';
+const { getArgumentValue } = FormulaProcessor;
+/* *
+ *
+ *  Functions
+ *
+ * */
+/**
+ * Processor for the `AVERAGEA(...values)` implementation. Calculates the
+ * average of the given values. Strings and FALSE are calculated as 0.
+ *
+ * @private
+ * @function Formula.processorFunctions.AVERAGEA
+ *
+ * @param {Highcharts.FormulaArguments} args
+ * Arguments to process.
+ *
+ * @param {Highcharts.DataTable} [table]
+ * Table to use for references and ranges.
+ *
+ * @return {number}
+ * Result value of the process.
+ */
+function AVERAGEA(args, table) {
+    let count = 0, result = 0;
+    for (let i = 0, iEnd = args.length, value; i < iEnd; ++i) {
+        value = getArgumentValue(args[i], table);
+        switch (typeof value) {
+            case 'boolean':
+                ++count;
+                result += (value ? 1 : 0);
+                continue;
+            case 'number':
+                if (!isNaN(value)) {
+                    ++count;
+                    result += value;
+                }
+                continue;
+            case 'string':
+                ++count;
+                continue;
+            default:
+                for (let j = 0, jEnd = value.length, value2; j < jEnd; ++j) {
+                    value2 = value[j];
+                    switch (typeof value2) {
+                        case 'boolean':
+                            ++count;
+                            result += (value2 ? 1 : 0);
+                            continue;
+                        case 'number':
+                            if (!isNaN(value2)) {
+                                ++count;
+                                result += value2;
+                            }
+                            continue;
+                        case 'string':
+                            ++count;
+                            continue;
+                    }
+                }
+                continue;
+        }
+    }
+    return (count ? (result / count) : 0);
+}
+/* *
+ *
+ *  Registry
+ *
+ * */
+FormulaProcessor.registerProcessorFunction('AVERAGEA', AVERAGEA);
+/* *
+ *
+ *  Default Export
+ *
+ * */
+export default AVERAGEA;

package/es-modules/Data/Formula/Functions/COUNT.d.ts

@@ -0,0 +1,20 @@
+import type { Arguments } from '../FormulaTypes';
+import type DataTable from '../../DataTable';
+/**
+ * Processor for the `COUNT(...values)` implementation. Returns the count of
+ * given values that are numbers.
+ *
+ * @private
+ * @function Formula.processorFunctions.COUNT
+ *
+ * @param {Highcharts.FormulaArguments} args
+ * Arguments to process.
+ *
+ * @param {Highcharts.DataTable} [table]
+ * Table to use for references and ranges.
+ *
+ * @return {number}
+ * Result value of the process.
+ */
+declare function COUNT(args: Arguments, table?: DataTable): number;
+export default COUNT;

package/es-modules/Data/Formula/Functions/COUNT.js

@@ -0,0 +1,65 @@
+/* *
+ *
+ *  (c) 2009-2025 Highsoft AS
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ *  Authors:
+ *  - Sophie Bremer
+ *
+ * */
+'use strict';
+import FormulaProcessor from '../FormulaProcessor.js';
+/* *
+ *
+ *  Functions
+ *
+ * */
+/**
+ * Processor for the `COUNT(...values)` implementation. Returns the count of
+ * given values that are numbers.
+ *
+ * @private
+ * @function Formula.processorFunctions.COUNT
+ *
+ * @param {Highcharts.FormulaArguments} args
+ * Arguments to process.
+ *
+ * @param {Highcharts.DataTable} [table]
+ * Table to use for references and ranges.
+ *
+ * @return {number}
+ * Result value of the process.
+ */
+function COUNT(args, table) {
+    const values = FormulaProcessor.getArgumentsValues(args, table);
+    let count = 0;
+    for (let i = 0, iEnd = values.length, value; i < iEnd; ++i) {
+        value = values[i];
+        switch (typeof value) {
+            case 'number':
+                if (!isNaN(value)) {
+                    ++count;
+                }
+                break;
+            case 'object':
+                count += COUNT(value, table);
+                break;
+        }
+    }
+    return count;
+}
+/* *
+ *
+ *  Registry
+ *
+ * */
+FormulaProcessor.registerProcessorFunction('COUNT', COUNT);
+/* *
+ *
+ *  Default Export
+ *
+ * */
+export default COUNT;

package/es-modules/Data/Formula/Functions/COUNTA.d.ts

@@ -0,0 +1,20 @@
+import type { Arguments } from '../FormulaTypes';
+import type DataTable from '../../DataTable';
+/**
+ * Processor for the `COUNTA(...values)` implementation. Returns the count of
+ * given values that are not empty.
+ *
+ * @private
+ * @function Formula.processorFunctions.COUNT
+ *
+ * @param {Highcharts.FormulaArguments} args
+ * Arguments to process.
+ *
+ * @param {Highcharts.DataTable} [table]
+ * Table to use for references and ranges.
+ *
+ * @return {number}
+ * Result value of the process.
+ */
+declare function COUNTA(args: Arguments, table?: DataTable): number;
+export default COUNTA;

package/es-modules/Data/Formula/Functions/COUNTA.js

@@ -0,0 +1,71 @@
+/* *
+ *
+ *  (c) 2009-2025 Highsoft AS
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ *  Authors:
+ *  - Sophie Bremer
+ *
+ * */
+'use strict';
+import FormulaProcessor from '../FormulaProcessor.js';
+/* *
+ *
+ *  Functions
+ *
+ * */
+/**
+ * Processor for the `COUNTA(...values)` implementation. Returns the count of
+ * given values that are not empty.
+ *
+ * @private
+ * @function Formula.processorFunctions.COUNT
+ *
+ * @param {Highcharts.FormulaArguments} args
+ * Arguments to process.
+ *
+ * @param {Highcharts.DataTable} [table]
+ * Table to use for references and ranges.
+ *
+ * @return {number}
+ * Result value of the process.
+ */
+function COUNTA(args, table) {
+    const values = FormulaProcessor.getArgumentsValues(args, table);
+    let count = 0;
+    for (let i = 0, iEnd = values.length, value; i < iEnd; ++i) {
+        value = values[i];
+        switch (typeof value) {
+            case 'number':
+                if (isNaN(value)) {
+                    continue;
+                }
+                break;
+            case 'object':
+                count += COUNTA(value, table);
+                continue;
+            case 'string':
+                if (!value) {
+                    continue;
+                }
+                break;
+        }
+        ++count;
+    }
+    return count;
+}
+/* *
+ *
+ *  Registry
+ *
+ * */
+FormulaProcessor.registerProcessorFunction('COUNTA', COUNTA);
+/* *
+ *
+ *  Default Export
+ *
+ * */
+export default COUNTA;