@carbon/charts 1.6.13 → 1.7.0

package/tools.js

@@ -1,377 +1,348 @@
 // Internal imports
 import { CartesianOrientations, ScaleTypes, TruncationTypes, } from './interfaces';
 import { defaultLegendAdditionalItems } from './configuration-non-customizable';
-import { debounce as lodashDebounce, merge as lodashMerge, cloneDeep as lodashCloneDeep, unionBy as lodashUnionBy, uniq as lodashUnique, clamp as lodashClamp, flatten as lodashFlatten, groupBy as lodashGroupBy, camelCase as lodashCamelCase, isEmpty as lodashIsEmpty, isEqual as lodashIsEqual, flatMapDeep as lodashFlatMapDeep, kebabCase as lodashKebabCase, fromPairs as lodashFromPairs, some as lodashSome, } from 'lodash-es';
+import { debounce, merge, cloneDeep, unionBy, uniq, clamp, flatten, groupBy, camelCase, isEmpty, isEqual, flatMapDeep, kebabCase, fromPairs, some, } from 'lodash-es';
 // D3 Imports
 // @ts-ignore
 // ts-ignore is needed because `@types/d3`
 // is missing the `pointer` function
 import { pointer } from 'd3-selection';
 // Functions
-export var Tools;
-(function (Tools) {
-    // Export these functions from lodash
-    Tools.debounce = lodashDebounce;
-    Tools.clone = lodashCloneDeep;
-    Tools.merge = lodashMerge;
-    Tools.unionBy = lodashUnionBy;
-    Tools.removeArrayDuplicates = lodashUnique;
-    Tools.clamp = lodashClamp;
-    Tools.flatten = lodashFlatten;
-    Tools.groupBy = lodashGroupBy;
-    Tools.camelCase = lodashCamelCase;
-    Tools.isEmpty = lodashIsEmpty;
-    Tools.isEqual = lodashIsEqual;
-    Tools.flatMapDeep = lodashFlatMapDeep;
-    Tools.kebabCase = lodashKebabCase;
-    Tools.fromPairs = lodashFromPairs;
-    Tools.some = lodashSome;
-    function debounceWithD3MousePosition(fn, delay, holder) {
-        var timer = null;
-        return function () {
-            var context = this;
-            var args = arguments;
-            //we get the D3 event here
-            context.mousePosition = pointer(args[0], holder);
-            clearTimeout(timer);
-            timer = setTimeout(function () {
-                // and use the reference here
-                fn.apply(context, args);
-            }, delay);
-        };
+// Export these functions from lodash
+export { debounce, merge, unionBy, clamp, flatten, groupBy, camelCase, isEmpty, isEqual, flatMapDeep, kebabCase, fromPairs, some, };
+export var clone = cloneDeep;
+export var removeArrayDuplicates = uniq;
+export function debounceWithD3MousePosition(fn, delay, holder) {
+    var timer = null;
+    return function () {
+        var context = this;
+        var args = arguments;
+        //we get the D3 event here
+        context.mousePosition = pointer(args[0], holder);
+        clearTimeout(timer);
+        timer = setTimeout(function () {
+            // and use the reference here
+            fn.apply(context, args);
+        }, delay);
+    };
+}
+/**
+ * Returns default chart options merged with provided options,
+ * with special cases for axes.
+ * Axes object will not merge the not provided axes.
+ *
+ * @export
+ * @param {AxisChartOptions} defaultOptions Configuration.options[chartType]
+ * @param {AxisChartOptions} providedOptions user provided options
+ * @returns merged options
+ */
+export function mergeDefaultChartOptions(defaultOptions, providedOptions) {
+    var _a, _b;
+    var clonedDefaultOptions = clone(defaultOptions);
+    var providedAxesNames = Object.keys(providedOptions.axes || {});
+    // Use provide controls list if it exists
+    // Prevents merging and element overriding of the two lists
+    if ((_b = (_a = providedOptions) === null || _a === void 0 ? void 0 : _a.toolbar) === null || _b === void 0 ? void 0 : _b.controls) {
+        delete clonedDefaultOptions.toolbar.controls;
     }
-    Tools.debounceWithD3MousePosition = debounceWithD3MousePosition;
-    /**
-     * Returns default chart options merged with provided options,
-     * with special cases for axes.
-     * Axes object will not merge the not provided axes.
-     *
-     * @export
-     * @param {AxisChartOptions} defaultOptions Configuration.options[chartType]
-     * @param {AxisChartOptions} providedOptions user provided options
-     * @returns merged options
-     */
-    function mergeDefaultChartOptions(defaultOptions, providedOptions) {
-        var _a, _b;
-        var clonedDefaultOptions = Tools.clone(defaultOptions);
-        var providedAxesNames = Object.keys(providedOptions.axes || {});
-        // Use provide controls list if it exists
-        // Prevents merging and element overriding of the two lists
-        if ((_b = (_a = providedOptions) === null || _a === void 0 ? void 0 : _a.toolbar) === null || _b === void 0 ? void 0 : _b.controls) {
-            delete clonedDefaultOptions.toolbar.controls;
-        }
-        if (providedAxesNames.length === 0) {
-            delete clonedDefaultOptions.axes;
-        }
-        // Update deprecated options to work with the tabular data format
-        // Similar to the functionality in model.transformToTabularData()
-        for (var axisName in clonedDefaultOptions.axes) {
-            if (providedAxesNames.includes(axisName)) {
-                var providedAxisOptions = providedOptions.axes[axisName];
-                if (providedAxisOptions['primary'] ||
-                    providedAxisOptions['secondary']) {
-                    console.warn('`primary` & `secondary` are no longer needed for axis configurations. Read more here https://carbon-design-system.github.io/carbon-charts/?path=/story/docs-tutorials--tabular-data-format');
+    if (providedAxesNames.length === 0) {
+        delete clonedDefaultOptions.axes;
+    }
+    // Update deprecated options to work with the tabular data format
+    // Similar to the functionality in model.transformToTabularData()
+    for (var axisName in clonedDefaultOptions.axes) {
+        if (providedAxesNames.includes(axisName)) {
+            var providedAxisOptions = providedOptions.axes[axisName];
+            if (providedAxisOptions['primary'] ||
+                providedAxisOptions['secondary']) {
+                console.warn('`primary` & `secondary` are no longer needed for axis configurations. Read more here https://carbon-design-system.github.io/carbon-charts/?path=/story/docs-tutorials--tabular-data-format');
+            }
+            var identifier = providedAxisOptions['mapsTo'];
+            if (identifier === undefined || identifier === null) {
+                var scaleType = providedAxisOptions['scaleType'];
+                if (scaleType === undefined || scaleType === null) {
+                    providedAxisOptions['mapsTo'] = 'value';
                 }
-                var identifier = providedAxisOptions['mapsTo'];
-                if (identifier === undefined || identifier === null) {
-                    var scaleType = providedAxisOptions['scaleType'];
-                    if (scaleType === undefined || scaleType === null) {
-                        providedAxisOptions['mapsTo'] = 'value';
-                    }
-                    else if (scaleType === ScaleTypes.TIME) {
-                        providedAxisOptions['mapsTo'] = 'date';
-                    }
-                    else if (scaleType === ScaleTypes.LABELS) {
-                        providedAxisOptions['mapsTo'] = 'key';
-                    }
+                else if (scaleType === ScaleTypes.TIME) {
+                    providedAxisOptions['mapsTo'] = 'date';
+                }
+                else if (scaleType === ScaleTypes.LABELS) {
+                    providedAxisOptions['mapsTo'] = 'key';
                 }
             }
-            else {
-                delete clonedDefaultOptions.axes[axisName];
-            }
         }
-        updateLegendAdditionalItems(clonedDefaultOptions, providedOptions);
-        return Tools.merge(clonedDefaultOptions, providedOptions);
+        else {
+            delete clonedDefaultOptions.axes[axisName];
+        }
     }
-    Tools.mergeDefaultChartOptions = mergeDefaultChartOptions;
-    /**************************************
-     *  DOM-related operations            *
-     *************************************/
-    /**
-     * Get width & height of an element
-     *
-     * @export
-     * @param {any} el element to get dimensions from
-     * @returns an object containing the width and height of el
-     */
-    function getDimensions(el) {
-        return {
-            width: parseFloat(el.style.width.replace('px', '') || el.offsetWidth),
-            height: parseFloat(el.style.height.replace('px', '') || el.offsetHeight),
-        };
+    updateLegendAdditionalItems(clonedDefaultOptions, providedOptions);
+    return merge(clonedDefaultOptions, providedOptions);
+}
+/**************************************
+ *  DOM-related operations            *
+ *************************************/
+/**
+ * Get width & height of an element
+ *
+ * @export
+ * @param {any} el element to get dimensions from
+ * @returns an object containing the width and height of el
+ */
+export function getDimensions(el) {
+    return {
+        width: parseFloat(el.style.width.replace('px', '') || el.offsetWidth),
+        height: parseFloat(el.style.height.replace('px', '') || el.offsetHeight),
+    };
+}
+/**
+ * Gets elements's x and y translations from transform attribute or returns null
+ *
+ * @param {HTMLElement} element
+ * @returns an object containing the translated x and y values or null
+ */
+export function getTranslationValues(elementRef) {
+    if (!elementRef) {
+        return;
     }
-    Tools.getDimensions = getDimensions;
-    /**
-     * Gets elements's x and y translations from transform attribute or returns null
-     *
-     * @param {HTMLElement} element
-     * @returns an object containing the translated x and y values or null
-     */
-    function getTranslationValues(elementRef) {
-        if (!elementRef) {
-            return;
-        }
-        // regex to ONLY get values for translate (instead of all rotate, translate, skew, etc)
-        var translateRegex = /translate\([0-9]+\.?[0-9]*,[0-9]+\.?[0-9]*\)/;
-        var transformStr = elementRef
-            .getAttribute('transform')
-            .match(translateRegex);
-        if (!transformStr) {
-            return null;
-        }
-        // check for the match
-        if (transformStr[0]) {
-            var transforms = transformStr[0]
-                .replace(/translate\(/, '')
-                .replace(/\)/, '')
-                .split(',');
-            return {
-                tx: transforms[0],
-                ty: transforms[1],
-            };
-        }
+    // regex to ONLY get values for translate (instead of all rotate, translate, skew, etc)
+    var translateRegex = /translate\([0-9]+\.?[0-9]*,[0-9]+\.?[0-9]*\)/;
+    var transformStr = elementRef
+        .getAttribute('transform')
+        .match(translateRegex);
+    if (!transformStr) {
         return null;
     }
-    Tools.getTranslationValues = getTranslationValues;
-    /**************************************
-     *  Formatting & calculations         *
-     *************************************/
-    /**
-     * Gets x and y coordinates from HTML transform attribute
-     *
-     * @export
-     * @param {any} string the transform attribute string ie. transform(x,y)
-     * @returns Returns an object with x and y offsets of the transform
-     */
-    function getTranformOffsets(string) {
-        var regExp = /\(([^)]+)\)/;
-        var match = regExp.exec(string)[1];
-        var xyString = match.split(',');
+    // check for the match
+    if (transformStr[0]) {
+        var transforms = transformStr[0]
+            .replace(/translate\(/, '')
+            .replace(/\)/, '')
+            .split(',');
         return {
-            x: parseFloat(xyString[0]),
-            y: parseFloat(xyString[1]),
+            tx: transforms[0],
+            ty: transforms[1],
         };
     }
-    Tools.getTranformOffsets = getTranformOffsets;
-    /**
-     * Returns string value for height/width using pixels if there isn't a specified unit of measure
-     *
-     * @param value string or number value to be checked for unit of measure
-     */
-    function formatWidthHeightValues(value) {
-        var stringValue = value.toString();
-        // If the value provided contains any letters
-        // Return it the same way
-        if (stringValue.match(/[a-z]/i)) {
-            return stringValue;
-        }
-        return stringValue + 'px';
+    return null;
+}
+/**************************************
+ *  Formatting & calculations         *
+ *************************************/
+/**
+ * Gets x and y coordinates from HTML transform attribute
+ *
+ * @export
+ * @param {any} string the transform attribute string ie. transform(x,y)
+ * @returns Returns an object with x and y offsets of the transform
+ */
+export function getTranformOffsets(string) {
+    var regExp = /\(([^)]+)\)/;
+    var match = regExp.exec(string)[1];
+    var xyString = match.split(',');
+    return {
+        x: parseFloat(xyString[0]),
+        y: parseFloat(xyString[1]),
+    };
+}
+/**
+ * Returns string value for height/width using pixels if there isn't a specified unit of measure
+ *
+ * @param value string or number value to be checked for unit of measure
+ */
+export function formatWidthHeightValues(value) {
+    var stringValue = value.toString();
+    // If the value provided contains any letters
+    // Return it the same way
+    if (stringValue.match(/[a-z]/i)) {
+        return stringValue;
     }
-    Tools.formatWidthHeightValues = formatWidthHeightValues;
-    /**
-     * Capitalizes first letter of a string
-     *
-     * @export
-     * @param {any} string the input string to perform first letter capitalization with
-     * @returns The transformed string after first letter is capitalized
-     */
-    function capitalizeFirstLetter(string) {
-        return string[0].toUpperCase() + string.slice(1);
+    return stringValue + 'px';
+}
+/**
+ * Capitalizes first letter of a string
+ *
+ * @export
+ * @param {any} string the input string to perform first letter capitalization with
+ * @returns The transformed string after first letter is capitalized
+ */
+export function capitalizeFirstLetter(string) {
+    return string[0].toUpperCase() + string.slice(1);
+}
+/**
+ * Get the percentage of a datapoint compared to the entire dataset.
+ * @export
+ * @param {any} item
+ * @param {any} fullData
+ * @param {string} key
+ * @returns The percentage in the form of a number (1 significant digit if necessary)
+ */
+export function convertValueToPercentage(item, fullData, key) {
+    if (key === void 0) { key = 'value'; }
+    var percentage = (item / fullData.reduce(function (accum, val) { return accum + val[key]; }, 0)) * 100;
+    // if the value has any significant figures, keep 1
+    return percentage % 1 !== 0
+        ? parseFloat(percentage.toFixed(1))
+        : percentage;
+}
+/**
+ * Truncate the labels
+ * @export
+ * @param {any} fullText
+ * @param {any} truncationType
+ * @param {any} numCharacter
+ * @returns Truncated text
+ */
+export function truncateLabel(fullText, truncationType, numCharacter) {
+    if (numCharacter > fullText.length) {
+        return fullText;
     }
-    Tools.capitalizeFirstLetter = capitalizeFirstLetter;
-    /**
-     * Get the percentage of a datapoint compared to the entire dataset.
-     * @export
-     * @param {any} item
-     * @param {any} fullData
-     * @param {string} key
-     * @returns The percentage in the form of a number (1 significant digit if necessary)
-     */
-    function convertValueToPercentage(item, fullData, key) {
-        if (key === void 0) { key = 'value'; }
-        var percentage = (item / fullData.reduce(function (accum, val) { return accum + val[key]; }, 0)) * 100;
-        // if the value has any significant figures, keep 1
-        return percentage % 1 !== 0
-            ? parseFloat(percentage.toFixed(1))
-            : percentage;
+    if (truncationType === TruncationTypes.MID_LINE) {
+        return (fullText.substr(0, numCharacter / 2) +
+            '...' +
+            fullText.substr(-numCharacter / 2));
     }
-    Tools.convertValueToPercentage = convertValueToPercentage;
-    /**
-     * Truncate the labels
-     * @export
-     * @param {any} fullText
-     * @param {any} truncationType
-     * @param {any} numCharacter
-     * @returns Truncated text
-     */
-    function truncateLabel(fullText, truncationType, numCharacter) {
-        if (numCharacter > fullText.length) {
-            return fullText;
-        }
-        if (truncationType === TruncationTypes.MID_LINE) {
-            return (fullText.substr(0, numCharacter / 2) +
-                '...' +
-                fullText.substr(-numCharacter / 2));
-        }
-        else if (truncationType === TruncationTypes.FRONT_LINE) {
-            return '...' + fullText.substr(-numCharacter);
-        }
-        else if (truncationType === TruncationTypes.END_LINE) {
-            return fullText.substr(0, numCharacter) + '...';
-        }
+    else if (truncationType === TruncationTypes.FRONT_LINE) {
+        return '...' + fullText.substr(-numCharacter);
     }
-    Tools.truncateLabel = truncateLabel;
-    /**
-     * Update legend additional items
-     * @param {any} defaultOptions
-     * @param {any} providedOptions
-     */
-    function updateLegendAdditionalItems(defaultOptions, providedOptions) {
-        var defaultAdditionalItems = Tools.getProperty(defaultOptions, 'legend', 'additionalItems');
-        var userProvidedAdditionalItems = Tools.getProperty(providedOptions, 'legend', 'additionalItems');
-        // Retain default legend additional items
-        if (defaultAdditionalItems && userProvidedAdditionalItems) {
-            var providedTypes_1 = userProvidedAdditionalItems.map(function (item) { return item.type; });
-            var defaultTypes_1 = defaultAdditionalItems.map(function (item) { return item.type; });
-            // Get default items in default options but not in provided options
-            var updatedDefaultItems = defaultLegendAdditionalItems.filter(function (item) {
-                return defaultTypes_1.includes(item.type) &&
-                    !providedTypes_1.includes(item.type);
-            });
-            defaultOptions.legend.additionalItems = updatedDefaultItems;
-            providedOptions.legend.additionalItems = Tools.unionBy(updatedDefaultItems, userProvidedAdditionalItems, 'name');
-        }
+    else if (truncationType === TruncationTypes.END_LINE) {
+        return fullText.substr(0, numCharacter) + '...';
     }
-    Tools.updateLegendAdditionalItems = updateLegendAdditionalItems;
-    /**************************************
-     *  Object/array related checks       *
-     *************************************/
-    /**
-     * Compares two arrays to return the difference between two arrays' items.
-     *
-     * @export
-     * @param {any[]} oldArray the array to check for missing items
-     * @param {any[]} newArray the array to check for newly added items
-     * @returns An object containing items missing (existing in oldArray but not newArray)
-     * and items added (existing in newArray but not in oldArray). Object is of the form { missing: [], added: [] }
-     */
-    function arrayDifferences(oldArray, newArray) {
-        var difference = {
-            missing: [],
-            added: [],
-        };
-        oldArray.forEach(function (element) {
-            if (newArray.indexOf(element) === -1) {
-                difference.missing.push(element);
-            }
-        });
-        newArray.forEach(function (element) {
-            if (oldArray.indexOf(element) === -1) {
-                difference.added.push(element);
-            }
-        });
-        return difference;
-    }
-    Tools.arrayDifferences = arrayDifferences;
-    /**
-     * Gets the duplicated keys from an array of data
-     *
-     * @export
-     * @param {*} data - array of data
-     * @returns A list of the duplicated keys in data
-     */
-    function getDuplicateValues(arr) {
-        var values = [];
-        var duplicateValues = [];
-        arr.forEach(function (value) {
-            if (values.indexOf(value) !== -1 &&
-                duplicateValues.indexOf(value) === -1) {
-                duplicateValues.push(value);
-            }
-            values.push(value);
-        });
-        return duplicateValues;
-    }
-    Tools.getDuplicateValues = getDuplicateValues;
-    // ================================================================================
-    // D3 Extensions
-    // ================================================================================
-    /**
-     * In D3, moves an element to the front of the canvas
-     *
-     * @export
-     * @param {any} element input element to moved in front
-     * @returns The function to be used by D3 to push element to the top of the canvas
-     */
-    function moveToFront(element) {
-        return element.each(function () {
-            this.parentNode.appendChild(this);
+}
+/**
+ * Update legend additional items
+ * @param {any} defaultOptions
+ * @param {any} providedOptions
+ */
+export function updateLegendAdditionalItems(defaultOptions, providedOptions) {
+    var defaultAdditionalItems = getProperty(defaultOptions, 'legend', 'additionalItems');
+    var userProvidedAdditionalItems = getProperty(providedOptions, 'legend', 'additionalItems');
+    // Retain default legend additional items
+    if (defaultAdditionalItems && userProvidedAdditionalItems) {
+        var providedTypes_1 = userProvidedAdditionalItems.map(function (item) { return item.type; });
+        var defaultTypes_1 = defaultAdditionalItems.map(function (item) { return item.type; });
+        // Get default items in default options but not in provided options
+        var updatedDefaultItems = defaultLegendAdditionalItems.filter(function (item) {
+            return defaultTypes_1.includes(item.type) &&
+                !providedTypes_1.includes(item.type);
         });
+        defaultOptions.legend.additionalItems = updatedDefaultItems;
+        providedOptions.legend.additionalItems = unionBy(updatedDefaultItems, userProvidedAdditionalItems, 'name');
     }
-    Tools.moveToFront = moveToFront;
-    // ================================================================================
-    // Style Helpers
-    // ================================================================================
-    /**
-     * Gets a speicified property from within an object.
-     *
-     * @param object the object containing the property to retrieve
-     * @param propPath nested properties used to extract the final property from within the object
-     * (i.e "style", "color" would retrieve the color property from within an object that has "color" nested within "style")
-     */
-    Tools.getProperty = function (object) {
-        var propPath = [];
-        for (var _i = 1; _i < arguments.length; _i++) {
-            propPath[_i - 1] = arguments[_i];
+}
+/**************************************
+ *  Object/array related checks       *
+ *************************************/
+/**
+ * Compares two arrays to return the difference between two arrays' items.
+ *
+ * @export
+ * @param {any[]} oldArray the array to check for missing items
+ * @param {any[]} newArray the array to check for newly added items
+ * @returns An object containing items missing (existing in oldArray but not newArray)
+ * and items added (existing in newArray but not in oldArray). Object is of the form { missing: [], added: [] }
+ */
+export function arrayDifferences(oldArray, newArray) {
+    var difference = {
+        missing: [],
+        added: [],
+    };
+    oldArray.forEach(function (element) {
+        if (newArray.indexOf(element) === -1) {
+            difference.missing.push(element);
         }
-        var position = object;
-        if (position) {
-            for (var _a = 0, propPath_1 = propPath; _a < propPath_1.length; _a++) {
-                var prop = propPath_1[_a];
-                if (position[prop] !== null && position[prop] !== undefined) {
-                    position = position[prop];
-                }
-                else {
-                    return null;
-                }
-            }
-            return position;
+    });
+    newArray.forEach(function (element) {
+        if (oldArray.indexOf(element) === -1) {
+            difference.added.push(element);
         }
-        return null;
-    };
-    Tools.flipSVGCoordinatesBasedOnOrientation = function (verticalCoordinates, orientation) {
-        if (orientation === CartesianOrientations.HORIZONTAL) {
-            return {
-                y0: verticalCoordinates.x0,
-                y1: verticalCoordinates.x1,
-                x0: verticalCoordinates.y0,
-                x1: verticalCoordinates.y1,
-            };
+    });
+    return difference;
+}
+/**
+ * Gets the duplicated keys from an array of data
+ *
+ * @export
+ * @param {*} data - array of data
+ * @returns A list of the duplicated keys in data
+ */
+export function getDuplicateValues(arr) {
+    var values = [];
+    var duplicateValues = [];
+    arr.forEach(function (value) {
+        if (values.indexOf(value) !== -1 &&
+            duplicateValues.indexOf(value) === -1) {
+            duplicateValues.push(value);
         }
-        return verticalCoordinates;
-    };
-    Tools.generateSVGPathString = function (verticalCoordinates, orientation) {
-        var _a = Tools.flipSVGCoordinatesBasedOnOrientation(verticalCoordinates, orientation), x0 = _a.x0, x1 = _a.x1, y0 = _a.y0, y1 = _a.y1;
-        return "M" + x0 + "," + y0 + "L" + x0 + "," + y1 + "L" + x1 + "," + y1 + "L" + x1 + "," + y0 + "L" + x0 + "," + y0;
-    };
-    function flipDomainAndRangeBasedOnOrientation(domain, range, orientation) {
-        return orientation === CartesianOrientations.VERTICAL
-            ? [domain, range]
-            : [range, domain];
+        values.push(value);
+    });
+    return duplicateValues;
+}
+// ================================================================================
+// D3 Extensions
+// ================================================================================
+/**
+ * In D3, moves an element to the front of the canvas
+ *
+ * @export
+ * @param {any} element input element to moved in front
+ * @returns The function to be used by D3 to push element to the top of the canvas
+ */
+export function moveToFront(element) {
+    return element.each(function () {
+        this.parentNode.appendChild(this);
+    });
+}
+// ================================================================================
+// Style Helpers
+// ================================================================================
+/**
+ * Gets a speicified property from within an object.
+ *
+ * @param object the object containing the property to retrieve
+ * @param propPath nested properties used to extract the final property from within the object
+ * (i.e "style", "color" would retrieve the color property from within an object that has "color" nested within "style")
+ */
+export var getProperty = function (object) {
+    var propPath = [];
+    for (var _i = 1; _i < arguments.length; _i++) {
+        propPath[_i - 1] = arguments[_i];
     }
-    Tools.flipDomainAndRangeBasedOnOrientation = flipDomainAndRangeBasedOnOrientation;
-    Tools.compareNumeric = function (a, b) {
-        return Number(a) === Number(b);
-    };
-})(Tools || (Tools = {}));
+    var position = object;
+    if (position) {
+        for (var _a = 0, propPath_1 = propPath; _a < propPath_1.length; _a++) {
+            var prop = propPath_1[_a];
+            if (position[prop] !== null && position[prop] !== undefined) {
+                position = position[prop];
+            }
+            else {
+                return null;
+            }
+        }
+        return position;
+    }
+    return null;
+};
+export var flipSVGCoordinatesBasedOnOrientation = function (verticalCoordinates, orientation) {
+    if (orientation === CartesianOrientations.HORIZONTAL) {
+        return {
+            y0: verticalCoordinates.x0,
+            y1: verticalCoordinates.x1,
+            x0: verticalCoordinates.y0,
+            x1: verticalCoordinates.y1,
+        };
+    }
+    return verticalCoordinates;
+};
+export var generateSVGPathString = function (verticalCoordinates, orientation) {
+    var _a = flipSVGCoordinatesBasedOnOrientation(verticalCoordinates, orientation), x0 = _a.x0, x1 = _a.x1, y0 = _a.y0, y1 = _a.y1;
+    return "M" + x0 + "," + y0 + "L" + x0 + "," + y1 + "L" + x1 + "," + y1 + "L" + x1 + "," + y0 + "L" + x0 + "," + y0;
+};
+export function flipDomainAndRangeBasedOnOrientation(domain, range, orientation) {
+    return orientation === CartesianOrientations.VERTICAL
+        ? [domain, range]
+        : [range, domain];
+}
+export var compareNumeric = function (a, b) {
+    return Number(a) === Number(b);
+};
 //# sourceMappingURL=../src/tools.js.map