@perses-dev/core 0.35.0 → 0.36.0

package/dist/cjs/model/calculations.js

@@ -55,7 +55,7 @@ const CALCULATIONS_CONFIG = {
         description: 'Last numeric value'
     },
     Mean: {
-        label: 'Average',
+        label: 'Avg',
         description: 'Average value excluding nulls'
     },
     Sum: {

package/dist/cjs/model/index.js

@@ -30,6 +30,7 @@ _exportStar(require("./thresholds"), exports);
 _exportStar(require("./time"), exports);
 _exportStar(require("./time-series-data"), exports);
 _exportStar(require("./time-series-queries"), exports);
+_exportStar(require("./units"), exports);
 _exportStar(require("./variables"), exports);
 function _exportStar(from, to) {
     Object.keys(from).forEach(function(k) {

package/dist/cjs/model/legend.js

@@ -27,11 +27,14 @@ function _export(target, all) {
 _export(exports, {
     legendPositions: ()=>legendPositions,
     legendModes: ()=>legendModes,
+    legendSizes: ()=>legendSizes,
     isValidLegendPosition: ()=>isValidLegendPosition,
     isValidLegendMode: ()=>isValidLegendMode,
+    isValidLegendSize: ()=>isValidLegendSize,
     DEFAULT_LEGEND: ()=>DEFAULT_LEGEND,
     getLegendPosition: ()=>getLegendPosition,
-    getLegendMode: ()=>getLegendMode
+    getLegendMode: ()=>getLegendMode,
+    getLegendSize: ()=>getLegendSize
 });
 const legendPositions = [
     'Bottom',
@@ -41,15 +44,23 @@ const legendModes = [
     'List',
     'Table'
 ];
+const legendSizes = [
+    'Small',
+    'Medium'
+];
 function isValidLegendPosition(position) {
     return legendPositions.includes(position);
 }
 function isValidLegendMode(mode) {
     return legendModes.includes(mode);
 }
+function isValidLegendSize(size) {
+    return legendSizes.includes(size);
+}
 const DEFAULT_LEGEND = {
     position: 'Bottom',
-    mode: 'List'
+    mode: 'List',
+    size: 'Medium'
 };
 function getLegendPosition(position) {
     if (position === undefined) {
@@ -66,3 +77,9 @@ function getLegendMode(mode) {
     }
     return mode;
 }
+function getLegendSize(size) {
+    if (!size || !isValidLegendSize(size)) {
+        return DEFAULT_LEGEND.size;
+    }
+    return size;
+}

package/dist/cjs/model/units/bytes.js

@@ -0,0 +1,84 @@
+// Copyright 2023 The Perses Authors
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    BYTES_GROUP_CONFIG: ()=>BYTES_GROUP_CONFIG,
+    BYTES_UNIT_CONFIG: ()=>BYTES_UNIT_CONFIG,
+    formatBytes: ()=>formatBytes
+});
+const _numbro = /*#__PURE__*/ _interopRequireDefault(require("numbro"));
+const _constants = require("./constants");
+const _utils = require("./utils");
+function _interopRequireDefault(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+const DEFAULT_NUMBRO_MANTISSA = 2;
+const bytesUnitKinds = [
+    'Bytes'
+];
+const BYTES_GROUP_CONFIG = {
+    label: 'Bytes',
+    decimal_places: true,
+    abbreviate: true
+};
+const BYTES_UNIT_CONFIG = {
+    // These units are powers of 1000.
+    // In other words, 1 KB = 1000 bytes.
+    Bytes: {
+        group: 'Bytes',
+        label: 'Bytes'
+    }
+};
+function formatBytes(bytes, options) {
+    const { abbreviate , decimal_places  } = options;
+    if (!(0, _utils.shouldAbbreviate)(abbreviate) || Math.abs(bytes) < 1000) {
+        const formatterOptions = {
+            style: 'unit',
+            unit: 'byte',
+            unitDisplay: 'long',
+            useGrouping: true
+        };
+        if ((0, _utils.hasDecimalPlaces)(decimal_places)) {
+            formatterOptions.minimumFractionDigits = (0, _utils.limitDecimalPlaces)(decimal_places);
+            formatterOptions.maximumFractionDigits = (0, _utils.limitDecimalPlaces)(decimal_places);
+        } else {
+            // This can happen if bytes is between -1000 and 1000
+            if ((0, _utils.shouldAbbreviate)(abbreviate)) {
+                formatterOptions.maximumSignificantDigits = _constants.MAX_SIGNIFICANT_DIGITS;
+            }
+        }
+        return Intl.NumberFormat('en-US', formatterOptions).format(bytes);
+    }
+    // numbro is able to add units like KB, MB, GB, etc. correctly
+    return (0, _numbro.default)(bytes).format({
+        output: 'byte',
+        base: 'decimal',
+        spaceSeparated: true,
+        mantissa: (0, _utils.hasDecimalPlaces)(decimal_places) ? decimal_places : DEFAULT_NUMBRO_MANTISSA,
+        // trimMantissa trims trailing 0s
+        trimMantissa: !(0, _utils.hasDecimalPlaces)(decimal_places),
+        // optionalMantissa excludes all the decimal places if they're all zeros
+        optionalMantissa: !(0, _utils.hasDecimalPlaces)(decimal_places)
+    });
+}

package/dist/cjs/model/units/constants.js

@@ -0,0 +1,23 @@
+// Copyright 2023 The Perses Authors
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// Common constants needed across individual unit groups and the overall
+// combined units.
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "MAX_SIGNIFICANT_DIGITS", {
+    enumerable: true,
+    get: ()=>MAX_SIGNIFICANT_DIGITS
+});
+const MAX_SIGNIFICANT_DIGITS = 3;

package/dist/cjs/model/units/decimal.js

@@ -0,0 +1,62 @@
+// Copyright 2023 The Perses Authors
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    DECIMAL_GROUP_CONFIG: ()=>DECIMAL_GROUP_CONFIG,
+    DECIMAL_UNIT_CONFIG: ()=>DECIMAL_UNIT_CONFIG,
+    formatDecimal: ()=>formatDecimal
+});
+const _constants = require("./constants");
+const _utils = require("./utils");
+const decimalUnitKinds = [
+    'Decimal'
+];
+const DECIMAL_GROUP_CONFIG = {
+    label: 'Decimal',
+    decimal_places: true,
+    abbreviate: true
+};
+const DECIMAL_UNIT_CONFIG = {
+    Decimal: {
+        group: 'Decimal',
+        label: 'Decimal'
+    }
+};
+function formatDecimal(value, options) {
+    const { abbreviate , decimal_places  } = options;
+    const formatterOptions = {
+        style: 'decimal',
+        useGrouping: true
+    };
+    if ((0, _utils.shouldAbbreviate)(abbreviate)) {
+        formatterOptions.notation = 'compact';
+    }
+    if ((0, _utils.hasDecimalPlaces)(decimal_places)) {
+        formatterOptions.minimumFractionDigits = (0, _utils.limitDecimalPlaces)(decimal_places);
+        formatterOptions.maximumFractionDigits = (0, _utils.limitDecimalPlaces)(decimal_places);
+    } else {
+        if ((0, _utils.shouldAbbreviate)(abbreviate)) {
+            formatterOptions.maximumSignificantDigits = _constants.MAX_SIGNIFICANT_DIGITS;
+        }
+    }
+    return Intl.NumberFormat('en-US', formatterOptions).format(value);
+}

package/dist/cjs/model/units/index.js

@@ -0,0 +1,31 @@
+// Copyright 2023 The Perses Authors
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_exportStar(require("./utils"), exports);
+_exportStar(require("./units"), exports);
+_exportStar(require("./constants"), exports);
+_exportStar(require("./types"), exports);
+function _exportStar(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) Object.defineProperty(to, k, {
+            enumerable: true,
+            get: function() {
+                return from[k];
+            }
+        });
+    });
+    return from;
+}

package/dist/cjs/model/units/percent.js

@@ -0,0 +1,73 @@
+// Copyright 2023 The Perses Authors
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    PERCENT_GROUP_CONFIG: ()=>PERCENT_GROUP_CONFIG,
+    PERCENT_UNIT_CONFIG: ()=>PERCENT_UNIT_CONFIG,
+    formatPercent: ()=>formatPercent
+});
+const _constants = require("./constants");
+const _utils = require("./utils");
+const percentUnitKinds = [
+    'Percent',
+    'PercentDecimal',
+    '%'
+];
+const PERCENT_GROUP_CONFIG = {
+    label: 'Percent',
+    decimal_places: true
+};
+const PERCENT_GROUP = 'Percent';
+const PERCENT_UNIT_CONFIG = {
+    Percent: {
+        group: PERCENT_GROUP,
+        label: 'Percent (0-100)'
+    },
+    PercentDecimal: {
+        group: PERCENT_GROUP,
+        label: 'Percent (0.0-1.0)'
+    },
+    '%': {
+        // This option is not shown in the selector because it is a shorthand
+        // duplicate of `Percent`.
+        disableSelectorOption: true,
+        group: PERCENT_GROUP,
+        label: '%'
+    }
+};
+function formatPercent(value, { kind , decimal_places  }) {
+    // Intl.NumberFormat translates 0 -> 0%, 0.5 -> 50%, 1 -> 100%
+    if (kind === 'Percent') {
+        value = value / 100;
+    }
+    const formatterOptions = {
+        style: 'percent',
+        useGrouping: true
+    };
+    if ((0, _utils.hasDecimalPlaces)(decimal_places)) {
+        formatterOptions.minimumFractionDigits = (0, _utils.limitDecimalPlaces)(decimal_places);
+        formatterOptions.maximumFractionDigits = (0, _utils.limitDecimalPlaces)(decimal_places);
+    } else {
+        formatterOptions.maximumSignificantDigits = _constants.MAX_SIGNIFICANT_DIGITS;
+    }
+    return Intl.NumberFormat('en-US', formatterOptions).format(value);
+}

package/dist/cjs/model/units/time.js

@@ -0,0 +1,105 @@
+// Copyright 2023 The Perses Authors
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    PersesTimeToIntlTime: ()=>PersesTimeToIntlTime,
+    TIME_GROUP_CONFIG: ()=>TIME_GROUP_CONFIG,
+    TIME_UNIT_CONFIG: ()=>TIME_UNIT_CONFIG,
+    formatTime: ()=>formatTime
+});
+const _constants = require("./constants");
+const _utils = require("./utils");
+const timeUnitKinds = [
+    'Milliseconds',
+    'Seconds',
+    'Minutes',
+    'Hours',
+    'Days',
+    'Weeks',
+    'Months',
+    'Years'
+];
+const TIME_GROUP = 'Time';
+const TIME_GROUP_CONFIG = {
+    label: 'Time',
+    decimal_places: true
+};
+const TIME_UNIT_CONFIG = {
+    Milliseconds: {
+        group: TIME_GROUP,
+        label: 'Milliseconds'
+    },
+    Seconds: {
+        group: TIME_GROUP,
+        label: 'Seconds'
+    },
+    Minutes: {
+        group: TIME_GROUP,
+        label: 'Minutes'
+    },
+    Hours: {
+        group: TIME_GROUP,
+        label: 'Hours'
+    },
+    Days: {
+        group: TIME_GROUP,
+        label: 'Days'
+    },
+    Weeks: {
+        group: TIME_GROUP,
+        label: 'Weeks'
+    },
+    Months: {
+        group: TIME_GROUP,
+        label: 'Months'
+    },
+    Years: {
+        group: TIME_GROUP,
+        label: 'Years'
+    }
+};
+var PersesTimeToIntlTime;
+(function(PersesTimeToIntlTime) {
+    PersesTimeToIntlTime["Milliseconds"] = 'millisecond';
+    PersesTimeToIntlTime["Seconds"] = 'second';
+    PersesTimeToIntlTime["Minutes"] = 'minute';
+    PersesTimeToIntlTime["Hours"] = 'hour';
+    PersesTimeToIntlTime["Days"] = 'day';
+    PersesTimeToIntlTime["Weeks"] = 'week';
+    PersesTimeToIntlTime["Months"] = 'month';
+    PersesTimeToIntlTime["Years"] = 'year';
+})(PersesTimeToIntlTime || (PersesTimeToIntlTime = {}));
+function formatTime(value, { kind , decimal_places  }) {
+    const isMonthOrYear = kind === 'Months' || kind === 'Years';
+    const formatterOptions = {
+        style: 'unit',
+        unit: PersesTimeToIntlTime[kind],
+        unitDisplay: isMonthOrYear ? 'long' : 'narrow'
+    };
+    if ((0, _utils.hasDecimalPlaces)(decimal_places)) {
+        formatterOptions.minimumFractionDigits = (0, _utils.limitDecimalPlaces)(decimal_places);
+        formatterOptions.maximumFractionDigits = (0, _utils.limitDecimalPlaces)(decimal_places);
+    } else {
+        formatterOptions.maximumSignificantDigits = _constants.MAX_SIGNIFICANT_DIGITS;
+    }
+    return Intl.NumberFormat('en-US', formatterOptions).format(value);
+}

package/dist/cjs/model/units/types.js

@@ -0,0 +1,28 @@
+// Copyright 2023 The Perses Authors
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// Common types needed across individual unit groups and the overall combined
+// units.
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "UNIT_GROUPS", {
+    enumerable: true,
+    get: ()=>UNIT_GROUPS
+});
+const UNIT_GROUPS = [
+    'Time',
+    'Percent',
+    'Decimal',
+    'Bytes'
+];

package/dist/cjs/model/units/units.js

@@ -0,0 +1,101 @@
+// Copyright 2023 The Perses Authors
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    UNIT_GROUP_CONFIG: ()=>UNIT_GROUP_CONFIG,
+    UNIT_CONFIG: ()=>UNIT_CONFIG,
+    formatValue: ()=>formatValue,
+    getUnitKindConfig: ()=>getUnitKindConfig,
+    getUnitGroup: ()=>getUnitGroup,
+    getUnitGroupConfig: ()=>getUnitGroupConfig,
+    isTimeUnit: ()=>isTimeUnit,
+    isPercentUnit: ()=>isPercentUnit,
+    isDecimalUnit: ()=>isDecimalUnit,
+    isBytesUnit: ()=>isBytesUnit,
+    isUnitWithDecimalPlaces: ()=>isUnitWithDecimalPlaces,
+    isUnitWithAbbreviate: ()=>isUnitWithAbbreviate
+});
+const _bytes = require("./bytes");
+const _decimal = require("./decimal");
+const _percent = require("./percent");
+const _time = require("./time");
+const UNIT_GROUP_CONFIG = {
+    Time: _time.TIME_GROUP_CONFIG,
+    Percent: _percent.PERCENT_GROUP_CONFIG,
+    Decimal: _decimal.DECIMAL_GROUP_CONFIG,
+    Bytes: _bytes.BYTES_GROUP_CONFIG
+};
+const UNIT_CONFIG = {
+    ..._time.TIME_UNIT_CONFIG,
+    ..._percent.PERCENT_UNIT_CONFIG,
+    ..._decimal.DECIMAL_UNIT_CONFIG,
+    ..._bytes.BYTES_UNIT_CONFIG
+};
+function formatValue(value, unitOptions) {
+    if (unitOptions === undefined) {
+        return value.toString();
+    }
+    if (isDecimalUnit(unitOptions)) {
+        return (0, _decimal.formatDecimal)(value, unitOptions);
+    }
+    if (isTimeUnit(unitOptions)) {
+        return (0, _time.formatTime)(value, unitOptions);
+    }
+    if (isPercentUnit(unitOptions)) {
+        return (0, _percent.formatPercent)(value, unitOptions);
+    }
+    if (isBytesUnit(unitOptions)) {
+        return (0, _bytes.formatBytes)(value, unitOptions);
+    }
+    const exhaustive = unitOptions;
+    throw new Error(`Unknown unit options ${exhaustive}`);
+}
+function getUnitKindConfig(unitOptions) {
+    return UNIT_CONFIG[unitOptions.kind];
+}
+function getUnitGroup(unitOptions) {
+    return getUnitKindConfig(unitOptions).group;
+}
+function getUnitGroupConfig(unitOptions) {
+    const unitConfig = getUnitKindConfig(unitOptions);
+    return UNIT_GROUP_CONFIG[unitConfig.group];
+}
+function isTimeUnit(unitOptions) {
+    return getUnitGroup(unitOptions) === 'Time';
+}
+function isPercentUnit(unitOptions) {
+    return getUnitGroup(unitOptions) === 'Percent';
+}
+function isDecimalUnit(unitOptions) {
+    return getUnitGroup(unitOptions) === 'Decimal';
+}
+function isBytesUnit(unitOptions) {
+    return getUnitGroup(unitOptions) === 'Bytes';
+}
+function isUnitWithDecimalPlaces(unitOptions) {
+    const groupConfig = getUnitGroupConfig(unitOptions);
+    return !!groupConfig.decimal_places;
+}
+function isUnitWithAbbreviate(unitOptions) {
+    const groupConfig = getUnitGroupConfig(unitOptions);
+    return !!groupConfig.abbreviate;
+}

package/dist/cjs/model/units/utils.js

@@ -0,0 +1,42 @@
+// Copyright 2023 The Perses Authors
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    shouldAbbreviate: ()=>shouldAbbreviate,
+    hasDecimalPlaces: ()=>hasDecimalPlaces,
+    limitDecimalPlaces: ()=>limitDecimalPlaces
+});
+function shouldAbbreviate(abbreviate) {
+    return abbreviate !== false;
+}
+function hasDecimalPlaces(decimal_places) {
+    return typeof decimal_places === 'number';
+}
+function limitDecimalPlaces(num) {
+    if (!num) return num;
+    if (num < 0) {
+        num = 0;
+    } else if (num > 20) {
+        num = 20;
+    }
+    return num;
+}

package/dist/cjs/model/variables.js

@@ -14,3 +14,8 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
+Object.defineProperty(exports, "DEFAULT_ALL_VALUE", {
+    enumerable: true,
+    get: ()=>DEFAULT_ALL_VALUE
+});
+const DEFAULT_ALL_VALUE = '$__all';

package/dist/model/calculations.js

@@ -38,7 +38,7 @@ export const CALCULATIONS_CONFIG = {
         description: 'Last numeric value'
     },
     Mean: {
-        label: 'Average',
+        label: 'Avg',
         description: 'Average value excluding nulls'
     },
     Sum: {