@highcharts/grid-pro 2.0.0

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

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

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

@@ -0,0 +1,60 @@
+/* *
+ *
+ *  (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 `NOT(value)` implementation. Returns the opposite test
+ * result.
+ *
+ * @private
+ * @function Formula.processorFunctions.NOT
+ *
+ * @param {Highcharts.FormulaArguments} args
+ * Arguments to process.
+ *
+ * @param {Highcharts.DataTable} [table]
+ * Table to use for references and ranges.
+ *
+ * @return {boolean|number}
+ * Result value of the process.
+ */
+function NOT(args, table) {
+    let value = getArgumentValue(args[0], table);
+    if (typeof value === 'object') {
+        value = value[0];
+    }
+    switch (typeof value) {
+        case 'boolean':
+        case 'number':
+            return !value;
+    }
+    return NaN;
+}
+/* *
+ *
+ *  Registry
+ *
+ * */
+FormulaProcessor.registerProcessorFunction('NOT', NOT);
+/* *
+ *
+ *  Default Export
+ *
+ * */
+export default NOT;

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

@@ -0,0 +1,20 @@
+import type { Arguments } from '../FormulaTypes';
+import type DataTable from '../../DataTable';
+/**
+ * Processor for the `OR(...tests)` implementation. Returns `TRUE`, if one test
+ * result is 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 OR(args: Arguments, table?: DataTable): boolean;
+export default OR;

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

@@ -0,0 +1,62 @@
+/* *
+ *
+ *  (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 `OR(...tests)` implementation. Returns `TRUE`, if one test
+ * result is 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 OR(args, table) {
+    for (let i = 0, iEnd = args.length, value; i < iEnd; ++i) {
+        value = getArgumentValue(args[i], table);
+        if (typeof value === 'object') {
+            if (OR(value, table)) {
+                return true;
+            }
+        }
+        else if (value) {
+            return true;
+        }
+    }
+    return false;
+}
+/* *
+ *
+ *  Registry
+ *
+ * */
+FormulaProcessor.registerProcessorFunction('OR', OR);
+/* *
+ *
+ *  Default Export
+ *
+ * */
+export default OR;

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

@@ -0,0 +1,20 @@
+import type { Arguments } from '../FormulaTypes';
+import type DataTable from '../../DataTable';
+/**
+ * Processor for the `PRODUCT(...values)` implementation. Calculates the product
+ * of the given values.
+ *
+ * @private
+ * @function Formula.processorFunctions.PRODUCT
+ *
+ * @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 PRODUCT(args: Arguments, table?: DataTable): number;
+export default PRODUCT;

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

@@ -0,0 +1,68 @@
+/* *
+ *
+ *  (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 `PRODUCT(...values)` implementation. Calculates the product
+ * of the given values.
+ *
+ * @private
+ * @function Formula.processorFunctions.PRODUCT
+ *
+ * @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 PRODUCT(args, table) {
+    const values = getArgumentsValues(args, table);
+    let result = 1, calculated = false;
+    for (let i = 0, iEnd = values.length, value; i < iEnd; ++i) {
+        value = values[i];
+        switch (typeof value) {
+            case 'number':
+                if (!isNaN(value)) {
+                    calculated = true;
+                    result *= value;
+                }
+                break;
+            case 'object':
+                calculated = true;
+                result *= PRODUCT(value, table);
+                break;
+        }
+    }
+    return (calculated ? result : 0);
+}
+/* *
+ *
+ *  Registry
+ *
+ * */
+FormulaProcessor.registerProcessorFunction('PRODUCT', PRODUCT);
+/* *
+ *
+ *  Default Export
+ *
+ * */
+export default PRODUCT;

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

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

package/es-modules/Data/Formula/Functions/SUM.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 `SUM(...values)` implementation. Calculates the sum of the
+ * given values.
+ *
+ * @private
+ * @function Formula.processorFunctions.SUM
+ *
+ * @param {Highcharts.FormulaArguments} args
+ * Arguments to process.
+ *
+ * @param {Highcharts.DataTable} [table]
+ * Table to process.
+ *
+ * @return {number}
+ * Result value of the process.
+ */
+function SUM(args, table) {
+    const values = FormulaProcessor.getArgumentsValues(args, table);
+    let result = 0;
+    for (let i = 0, iEnd = values.length, value; i < iEnd; ++i) {
+        value = values[i];
+        switch (typeof value) {
+            case 'number':
+                if (!isNaN(value)) {
+                    result += value;
+                }
+                break;
+            case 'object':
+                result += SUM(value, table);
+                break;
+        }
+    }
+    return result;
+}
+/* *
+ *
+ *  Registry
+ *
+ * */
+FormulaProcessor.registerProcessorFunction('SUM', SUM); // 🐝
+/* *
+ *
+ *  Default Export
+ *
+ * */
+export default SUM;

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

@@ -0,0 +1,20 @@
+import type { Arguments } from '../FormulaTypes';
+import type DataTable from '../../DataTable';
+/**
+ * Processor for the `XOR(...tests)` implementation. Returns `TRUE`, if at least
+ * one of the given tests differs in result of other tests.
+ *
+ * @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|number}
+ * Result value of the process.
+ */
+declare function XOR(args: Arguments, table?: DataTable): (boolean | number);
+export default XOR;

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

@@ -0,0 +1,81 @@
+/* *
+ *
+ *  (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 `XOR(...tests)` implementation. Returns `TRUE`, if at least
+ * one of the given tests differs in result of other tests.
+ *
+ * @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|number}
+ * Result value of the process.
+ */
+function XOR(args, table) {
+    for (let i = 0, iEnd = args.length, lastValue, value; i < iEnd; ++i) {
+        value = getArgumentValue(args[i], table);
+        switch (typeof value) {
+            case 'boolean':
+            case 'number':
+                if (typeof lastValue === 'undefined') {
+                    lastValue = !!value;
+                }
+                else if (!!value !== lastValue) {
+                    return true;
+                }
+                break;
+            case 'object':
+                for (let j = 0, jEnd = value.length, value2; j < jEnd; ++j) {
+                    value2 = value[j];
+                    switch (typeof value2) {
+                        case 'boolean':
+                        case 'number':
+                            if (typeof lastValue === 'undefined') {
+                                lastValue = !!value2;
+                            }
+                            else if (!!value2 !== lastValue) {
+                                return true;
+                            }
+                            break;
+                    }
+                }
+                break;
+        }
+    }
+    return false;
+}
+/* *
+ *
+ *  Registry
+ *
+ * */
+FormulaProcessor.registerProcessorFunction('XOR', XOR);
+/* *
+ *
+ *  Default Export
+ *
+ * */
+export default XOR;

package/es-modules/Data/Modifiers/ChainModifier.d.ts

@@ -0,0 +1,128 @@
+import type ChainModifierOptions from './ChainModifierOptions';
+import type DataEvent from '../DataEvent';
+import type DataModifierEvent from './DataModifierEvent';
+import DataModifier from './DataModifier.js';
+import DataTable from '../DataTable.js';
+/**
+ * Modifies a table with the help of modifiers in an ordered chain.
+ *
+ */
+declare class ChainModifier extends DataModifier {
+    /**
+     * Default option for the ordered modifier chain.
+     */
+    static readonly defaultOptions: ChainModifierOptions;
+    /**
+     * Constructs an instance of the modifier chain.
+     *
+     * @param {Partial<ChainModifier.Options>} [options]
+     * Options to configure the modifier chain.
+     *
+     * @param {...DataModifier} [chain]
+     * Ordered chain of modifiers.
+     */
+    constructor(options?: Partial<ChainModifierOptions>, ...chain: Array<DataModifier>);
+    /**
+     * Ordered chain of modifiers.
+     */
+    readonly chain: Array<DataModifier>;
+    /**
+     * Options of the modifier chain.
+     */
+    readonly options: ChainModifierOptions;
+    /**
+     * Adds a configured modifier to the end of the modifier chain. Please note,
+     * that the modifier can be added multiple times.
+     *
+     * @param {DataModifier} modifier
+     * Configured modifier to add.
+     *
+     * @param {DataEvent.Detail} [eventDetail]
+     * Custom information for pending events.
+     */
+    add(modifier: DataModifier, eventDetail?: DataEvent.Detail): void;
+    /**
+     * Clears all modifiers from the chain.
+     *
+     * @param {DataEvent.Detail} [eventDetail]
+     * Custom information for pending events.
+     */
+    clear(eventDetail?: DataEvent.Detail): void;
+    /**
+     * Sequentially applies all modifiers in the chain to the given table,
+     * updating its `modified` property with the final result.
+     *
+     * *Note:* The `modified` property reference of the table gets replaced.
+     *
+     * @param {Highcharts.DataTable} table
+     * Table to modify.
+     *
+     * @param {DataEvent.Detail} [eventDetail]
+     * Custom information for pending events.
+     *
+     * @return {Promise<Highcharts.DataTable>}
+     * Table with `modified` property as a reference.
+     */
+    modify(table: DataTable, eventDetail?: DataEvent.Detail): Promise<DataTable>;
+    /**
+     * Applies several modifications to the table.
+     *
+     * *Note:* The `modified` property reference of the table gets replaced.
+     *
+     * @param {DataTable} table
+     * Table to modify.
+     *
+     * @param {DataEvent.Detail} [eventDetail]
+     * Custom information for pending events.
+     *
+     * @return {DataTable}
+     * Table as a reference.
+     *
+     * @emits ChainDataModifier#execute
+     * @emits ChainDataModifier#afterExecute
+     */
+    modifyTable(table: DataTable, eventDetail?: DataEvent.Detail): DataTable;
+    /**
+     * Removes a configured modifier from all positions in the modifier chain.
+     *
+     * @param {DataModifier} modifier
+     * Configured modifier to remove.
+     *
+     * @param {DataEvent.Detail} [eventDetail]
+     * Custom information for pending events.
+     */
+    remove(modifier: DataModifier, eventDetail?: DataEvent.Detail): void;
+    emit<E extends ChainModifier.Event>(e: E): void;
+    on<T extends ChainModifier.Event['type']>(type: T, callback: DataEvent.Callback<this, Extract<DataModifierEvent, {
+        type: T;
+    }>>): Function;
+}
+/**
+ * Additionally provided types for modifier events and options.
+ */
+declare namespace ChainModifier {
+    /**
+     * Event information.
+     */
+    type Event = ChainEvent | ModifierEvent;
+    /**
+     * Event object
+     */
+    interface ChainEvent extends DataEvent {
+        readonly type: ('clearChain' | 'afterClearChain' | DataModifierEvent['type']);
+        readonly table?: DataTable;
+    }
+    /**
+     * Event information for modifier operations.
+     */
+    interface ModifierEvent extends DataEvent {
+        readonly type: ('addModifier' | 'afterAddModifier' | 'removeModifier' | 'afterRemoveModifier');
+        readonly modifier: DataModifier;
+    }
+}
+declare module './DataModifierType' {
+    interface DataModifierTypes {
+        Chain: typeof ChainModifier;
+    }
+}
+export default ChainModifier;