@perses-dev/components 0.14.0 → 0.16.0

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

@@ -0,0 +1,64 @@
+// Copyright 2022 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,
+    PERCENT_UNIT_CONFIG: ()=>PERCENT_UNIT_CONFIG,
+    formatPercent: ()=>formatPercent
+});
+const _constants = require("./constants");
+const percentUnitKinds = [
+    'Percent',
+    'PercentDecimal',
+    '%'
+];
+const DECIMAL_GROUP_CONFIG = {
+    label: 'Decimal',
+    decimal_places: true,
+    abbreviate: 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, unitOptions) {
+    var _decimal_places;
+    const decimals = (_decimal_places = unitOptions.decimal_places) !== null && _decimal_places !== void 0 ? _decimal_places : _constants.DEFAULT_DECIMAL_PLACES;
+    if (unitOptions.kind === 'PercentDecimal') {
+        value = value * 100;
+    }
+    return value.toFixed(decimals) + '%';
+}

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

@@ -0,0 +1,138 @@
+// Copyright 2022 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, {
+    TIME_GROUP_CONFIG: ()=>TIME_GROUP_CONFIG,
+    TIME_UNIT_CONFIG: ()=>TIME_UNIT_CONFIG,
+    formatTime: ()=>formatTime
+});
+const _dateFns = require("date-fns");
+const timeUnitKinds = [
+    'Milliseconds',
+    'Seconds',
+    'Minutes',
+    'Hours',
+    'Days',
+    'Weeks',
+    'Months',
+    'Years'
+];
+const TIME_GROUP = 'Time';
+const TIME_GROUP_CONFIG = {
+    label: 'Time'
+};
+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'
+    }
+};
+function formatTime(value, unitOptions) {
+    // Create a Duration from the value based on what time unit it is
+    const duration = {};
+    switch(unitOptions.kind){
+        case 'Milliseconds':
+            duration.seconds = value / 1000;
+            break;
+        case 'Seconds':
+            duration.seconds = value;
+            break;
+        case 'Minutes':
+            duration.minutes = value;
+            break;
+        case 'Hours':
+            duration.hours = value;
+            break;
+        case 'Days':
+            duration.days = value;
+            break;
+        case 'Weeks':
+            duration.weeks = value;
+            break;
+        case 'Months':
+            duration.months = value;
+            break;
+        case 'Years':
+            duration.years = value;
+            break;
+        default:
+            {
+                const exhaustive = unitOptions.kind;
+                throw new Error(`Unknown time unit type ${exhaustive}`);
+            }
+    }
+    // Find the largest whole time unit we can display the value in and use it
+    const ms = (0, _dateFns.milliseconds)(duration);
+    const seconds = ms / 1000;
+    if (seconds < 1) {
+        return `${ms.toFixed()} milliseconds`;
+    }
+    const minutes = seconds / 60;
+    if (minutes < 1) {
+        return `${seconds.toFixed()} seconds`;
+    }
+    const hours = minutes / 60;
+    if (hours < 1) {
+        return `${minutes.toFixed()} minutes`;
+    }
+    const days = hours / 24;
+    if (days < 1) {
+        return `${hours.toFixed()} hours`;
+    }
+    const weeks = days / 7;
+    if (weeks < 1) {
+        return `${days.toFixed()} days`;
+    }
+    const years = weeks / 52;
+    if (years < 1) {
+        return `${weeks.toFixed()} weeks`;
+    }
+    return `${years.toFixed()} years`;
+}

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

@@ -0,0 +1,28 @@
+// Copyright 2022 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,104 @@
+// Copyright 2022 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 _constants = require("./constants");
+const _decimal = require("./decimal");
+const _percent = require("./percent");
+const _time = require("./time");
+const UNIT_GROUP_CONFIG = {
+    Time: _time.TIME_GROUP_CONFIG,
+    Percent: _decimal.PERCENT_GROUP_CONFIG,
+    Decimal: _percent.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)) {
+        var _decimal_places;
+        const decimals = (_decimal_places = unitOptions.decimal_places) !== null && _decimal_places !== void 0 ? _decimal_places : _constants.DEFAULT_DECIMAL_PLACES;
+        return (0, _bytes.formatBytes)(value, decimals);
+    }
+    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/utils/component-ids.js

@@ -0,0 +1,31 @@
+// Copyright 2022 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
+});
+Object.defineProperty(exports, "useId", {
+    enumerable: true,
+    get: ()=>useId
+});
+const _react = require("react");
+function useId(prefix) {
+    if (globalThis.useIdValue === undefined) {
+        globalThis.useIdValue = 0;
+    }
+    const id = (0, _react.useRef)(undefined);
+    if (id.current === undefined) {
+        id.current = `${prefix}-${globalThis.useIdValue++}`;
+    }
+    return id.current;
+}

package/dist/cjs/utils/index.js

@@ -16,6 +16,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 _exportStar(require("./combine-sx"), exports);
 _exportStar(require("./theme-gen"), exports);
+_exportStar(require("./component-ids"), exports);
 function _exportStar(from, to) {
     Object.keys(from).forEach(function(k) {
         if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) Object.defineProperty(to, k, {

package/dist/index.d.ts

@@ -1,14 +1,16 @@
+export * from './DateTimeRangePicker';
 export * from './Drawer';
 export * from './EChart';
 export * from './ErrorAlert';
 export * from './ErrorBoundary';
+export * from './GaugeChart';
 export * from './InfoTooltip';
 export * from './JSONEditor';
 export * from './Legend';
 export * from './LineChart';
-export * from './GaugeChart';
+export * from './OptionsEditorLayout';
 export * from './StatChart';
-export * from './TimeRangeSelector';
+export * from './UnitSelector';
 export * from './context/ChartsThemeProvider';
 export * from './utils';
 export * from './model';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -10,17 +10,19 @@
 // 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.
+export * from './DateTimeRangePicker';
 export * from './Drawer';
 export * from './EChart';
 export * from './ErrorAlert';
 export * from './ErrorBoundary';
+export * from './GaugeChart';
 export * from './InfoTooltip';
 export * from './JSONEditor';
 export * from './Legend';
 export * from './LineChart';
-export * from './GaugeChart';
+export * from './OptionsEditorLayout';
 export * from './StatChart';
-export * from './TimeRangeSelector';
+export * from './UnitSelector';
 export * from './context/ChartsThemeProvider';
 export * from './utils';
 export * from './model';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Copyright 2022 The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nexport * from './Drawer';\nexport * from './EChart';\nexport * from './ErrorAlert';\nexport * from './ErrorBoundary';\nexport * from './InfoTooltip';\nexport * from './JSONEditor';\nexport * from './Legend';\nexport * from './LineChart';\nexport * from './GaugeChart';\nexport * from './StatChart';\nexport * from './TimeRangeSelector';\nexport * from './context/ChartsThemeProvider';\nexport * from './utils';\nexport * from './model';\nexport * from './test-utils';\n"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,6CAA6C;AAC7C,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Copyright 2022 The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nexport * from './DateTimeRangePicker';\nexport * from './Drawer';\nexport * from './EChart';\nexport * from './ErrorAlert';\nexport * from './ErrorBoundary';\nexport * from './GaugeChart';\nexport * from './InfoTooltip';\nexport * from './JSONEditor';\nexport * from './Legend';\nexport * from './LineChart';\nexport * from './OptionsEditorLayout';\nexport * from './StatChart';\nexport * from './UnitSelector';\nexport * from './context/ChartsThemeProvider';\nexport * from './utils';\nexport * from './model';\nexport * from './test-utils';\n"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,6CAA6C;AAC7C,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC"}

package/dist/model/units/bytes.d.ts

@@ -0,0 +1,12 @@
+import { UnitGroupConfig, UnitConfig } from './types';
+declare const bytesUnitKinds: readonly ["Bytes"];
+declare type BytesUnitKind = typeof bytesUnitKinds[number];
+export declare type BytesUnitOptions = {
+    kind: BytesUnitKind;
+    decimal_places?: number;
+};
+export declare const BYTES_GROUP_CONFIG: UnitGroupConfig;
+export declare const BYTES_UNIT_CONFIG: Readonly<Record<BytesUnitKind, UnitConfig>>;
+export declare function formatBytes(bytes: number, decimals?: number): string;
+export {};
+//# sourceMappingURL=bytes.d.ts.map

package/dist/model/units/bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../../src/model/units/bytes.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEtD,QAAA,MAAM,cAAc,oBAAqB,CAAC;AAC1C,aAAK,aAAa,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AACnD,oBAAY,gBAAgB,GAAG;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AACF,eAAO,MAAM,kBAAkB,EAAE,eAGhC,CAAC;AACF,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,CAKzE,CAAC;AAGF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,UAYtD"}

package/dist/model/units/bytes.js

@@ -0,0 +1,48 @@
+// Copyright 2022 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.
+const bytesUnitKinds = [
+    'Bytes'
+];
+export const BYTES_GROUP_CONFIG = {
+    label: 'Bytes',
+    decimal_places: true
+};
+export const BYTES_UNIT_CONFIG = {
+    Bytes: {
+        group: 'Bytes',
+        label: 'Bytes'
+    }
+};
+// https://stackoverflow.com/questions/15900485/correct-way-to-convert-size-in-bytes-to-kb-mb-gb-in-javascript/18650828#18650828
+export function formatBytes(bytes, decimals = 2) {
+    if (bytes === 0) return '0 Bytes';
+    const k = 1024;
+    const dm = decimals < 0 ? 0 : decimals;
+    const sizes = [
+        'Bytes',
+        'KB',
+        'MB',
+        'GB',
+        'TB',
+        'PB',
+        'EB',
+        'ZB',
+        'YB'
+    ];
+    // Math.max(0, ...) ensures that we don't return -1 as a value for the index.
+    // Why? When the number of bytes are between -1 and 1, Math.floor(Math.log(bytes)/Math.log(1024)) returns -1.
+    const i = Math.max(0, Math.floor(Math.log(bytes) / Math.log(k)));
+    return parseFloat((bytes / Math.pow(k, i)).toFixed(dm)) + ' ' + sizes[i];
+}
+
+//# sourceMappingURL=bytes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/model/units/bytes.ts"],"sourcesContent":["// Copyright 2022 The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport { UnitGroupConfig, UnitConfig } from './types';\n\nconst bytesUnitKinds = ['Bytes'] as const;\ntype BytesUnitKind = typeof bytesUnitKinds[number];\nexport type BytesUnitOptions = {\n  kind: BytesUnitKind;\n  decimal_places?: number;\n};\nexport const BYTES_GROUP_CONFIG: UnitGroupConfig = {\n  label: 'Bytes',\n  decimal_places: true,\n};\nexport const BYTES_UNIT_CONFIG: Readonly<Record<BytesUnitKind, UnitConfig>> = {\n  Bytes: {\n    group: 'Bytes',\n    label: 'Bytes',\n  },\n};\n\n// https://stackoverflow.com/questions/15900485/correct-way-to-convert-size-in-bytes-to-kb-mb-gb-in-javascript/18650828#18650828\nexport function formatBytes(bytes: number, decimals = 2) {\n  if (bytes === 0) return '0 Bytes';\n\n  const k = 1024;\n  const dm = decimals < 0 ? 0 : decimals;\n  const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];\n\n  // Math.max(0, ...) ensures that we don't return -1 as a value for the index.\n  // Why? When the number of bytes are between -1 and 1, Math.floor(Math.log(bytes)/Math.log(1024)) returns -1.\n  const i = Math.max(0, Math.floor(Math.log(bytes) / Math.log(k)));\n\n  return parseFloat((bytes / Math.pow(k, i)).toFixed(dm)) + ' ' + sizes[i];\n}\n"],"names":["bytesUnitKinds","BYTES_GROUP_CONFIG","label","decimal_places","BYTES_UNIT_CONFIG","Bytes","group","formatBytes","bytes","decimals","k","dm","sizes","i","Math","max","floor","log","parseFloat","pow","toFixed"],"mappings":"AAAA,oCAAoC;AACpC,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,6CAA6C;AAC7C,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAIjC,MAAMA,cAAc,GAAG;IAAC,OAAO;CAAC,AAAS,AAAC;AAM1C,OAAO,MAAMC,kBAAkB,GAAoB;IACjDC,KAAK,EAAE,OAAO;IACdC,cAAc,EAAE,IAAI;CACrB,CAAC;AACF,OAAO,MAAMC,iBAAiB,GAAgD;IAC5EC,KAAK,EAAE;QACLC,KAAK,EAAE,OAAO;QACdJ,KAAK,EAAE,OAAO;KACf;CACF,CAAC;AAEF,gIAAgI;AAChI,OAAO,SAASK,WAAW,CAACC,KAAa,EAAEC,QAAQ,GAAG,CAAC,EAAE;IACvD,IAAID,KAAK,KAAK,CAAC,EAAE,OAAO,SAAS,CAAC;IAElC,MAAME,CAAC,GAAG,IAAI,AAAC;IACf,MAAMC,EAAE,GAAGF,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAGA,QAAQ,AAAC;IACvC,MAAMG,KAAK,GAAG;QAAC,OAAO;QAAE,IAAI;QAAE,IAAI;QAAE,IAAI;QAAE,IAAI;QAAE,IAAI;QAAE,IAAI;QAAE,IAAI;QAAE,IAAI;KAAC,AAAC;IAExE,6EAA6E;IAC7E,6GAA6G;IAC7G,MAAMC,CAAC,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAED,IAAI,CAACE,KAAK,CAACF,IAAI,CAACG,GAAG,CAACT,KAAK,CAAC,GAAGM,IAAI,CAACG,GAAG,CAACP,CAAC,CAAC,CAAC,CAAC,AAAC;IAEjE,OAAOQ,UAAU,CAAC,AAACV,CAAAA,KAAK,GAAGM,IAAI,CAACK,GAAG,CAACT,CAAC,EAAEG,CAAC,CAAC,CAAA,CAAEO,OAAO,CAACT,EAAE,CAAC,CAAC,GAAG,GAAG,GAAGC,KAAK,CAACC,CAAC,CAAC,CAAC;AAC3E,CAAC"}

package/dist/model/units/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_DECIMAL_PLACES = 2;
+//# sourceMappingURL=constants.d.ts.map

package/dist/model/units/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/model/units/constants.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,sBAAsB,IAAI,CAAC"}

package/dist/model/units/constants.js

@@ -0,0 +1,17 @@
+// Copyright 2022 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.
+export const DEFAULT_DECIMAL_PLACES = 2;
+
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/model/units/constants.ts"],"sourcesContent":["// Copyright 2022 The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\n// Common constants needed across individual unit groups and the overall\n// combined units.\nexport const DEFAULT_DECIMAL_PLACES = 2;\n"],"names":["DEFAULT_DECIMAL_PLACES"],"mappings":"AAAA,oCAAoC;AACpC,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,6CAA6C;AAC7C,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,wEAAwE;AACxE,kBAAkB;AAClB,OAAO,MAAMA,sBAAsB,GAAG,CAAC,CAAC"}

package/dist/model/units/decimal.d.ts

@@ -0,0 +1,24 @@
+import { UnitGroupConfig, UnitConfig } from './types';
+declare const decimalUnitKinds: readonly ["Decimal"];
+declare type DecimalUnitKind = typeof decimalUnitKinds[number];
+export declare type DecimalUnitOptions = {
+    kind: DecimalUnitKind;
+    decimal_places?: number;
+    abbreviate?: boolean;
+};
+export declare const PERCENT_GROUP_CONFIG: UnitGroupConfig;
+export declare const DECIMAL_UNIT_CONFIG: Readonly<Record<DecimalUnitKind, UnitConfig>>;
+export declare function formatDecimal(value: number, unitOptions: DecimalUnitOptions): string;
+/**
+ * Takes large numbers and abbreviates them with the appropriate suffix
+ * 10123 -> 10.123k
+ * 1000000 -> 1M
+ */
+export declare function abbreviateLargeNumber(num: number, decimals?: number): string;
+/**
+ * Takes large numbers, rounds and abbreviates them with the appropriate suffix
+ * Add modifier to run on output value prior to unit being added (defaults to rounding)
+ */
+export declare function formatNumber(num: number, modifier?: (n: number) => number): string;
+export {};
+//# sourceMappingURL=decimal.d.ts.map

package/dist/model/units/decimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../../../src/model/units/decimal.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEtD,QAAA,MAAM,gBAAgB,sBAAuB,CAAC;AAC9C,aAAK,eAAe,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACvD,oBAAY,kBAAkB,GAAG;IAC/B,IAAI,EAAE,eAAe,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AACF,eAAO,MAAM,oBAAoB,EAAE,eAGlC,CAAC;AACF,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,UAAU,CAAC,CAK7E,CAAC;AAEF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,GAAG,MAAM,CAepF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAI,UAG9D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAYlF"}

package/dist/model/units/decimal.js

@@ -0,0 +1,59 @@
+// Copyright 2022 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.
+import { round } from '../../utils/mathjs';
+import { DEFAULT_DECIMAL_PLACES } from './constants';
+const decimalUnitKinds = [
+    'Decimal'
+];
+export const PERCENT_GROUP_CONFIG = {
+    label: 'Percent',
+    decimal_places: true
+};
+export const DECIMAL_UNIT_CONFIG = {
+    Decimal: {
+        group: 'Decimal',
+        label: 'Decimal'
+    }
+};
+export function formatDecimal(value, unitOptions) {
+    var _decimal_places;
+    const decimals = (_decimal_places = unitOptions.decimal_places) !== null && _decimal_places !== void 0 ? _decimal_places : DEFAULT_DECIMAL_PLACES;
+    if (unitOptions.abbreviate === true) {
+        return abbreviateLargeNumber(value, decimals);
+    }
+    const formatParams = {
+        style: 'decimal',
+        minimumFractionDigits: decimals,
+        maximumFractionDigits: decimals,
+        useGrouping: true
+    };
+    const decimalFormatter = new Intl.NumberFormat('en-US', formatParams);
+    return decimalFormatter.format(value);
+}
+/**
+ * Takes large numbers and abbreviates them with the appropriate suffix
+ * 10123 -> 10.123k
+ * 1000000 -> 1M
+ */ export function abbreviateLargeNumber(num, decimals = 2) {
+    const modifier = (n)=>round(n, decimals);
+    return formatNumber(num, modifier);
+}
+/**
+ * Takes large numbers, rounds and abbreviates them with the appropriate suffix
+ * Add modifier to run on output value prior to unit being added (defaults to rounding)
+ */ export function formatNumber(num, modifier) {
+    const fn = modifier !== null && modifier !== void 0 ? modifier : Math.round;
+    return num >= 1e12 ? fn(num / 1e12) + 'T' : num >= 1e9 ? fn(num / 1e9) + 'B' : num >= 1e6 ? fn(num / 1e6) + 'M' : num >= 1e3 ? fn(num / 1e3) + 'K' : num.toString();
+}
+
+//# sourceMappingURL=decimal.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/model/units/decimal.ts"],"sourcesContent":["// Copyright 2022 The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport { round } from '../../utils/mathjs';\nimport { DEFAULT_DECIMAL_PLACES } from './constants';\nimport { UnitGroupConfig, UnitConfig } from './types';\n\nconst decimalUnitKinds = ['Decimal'] as const;\ntype DecimalUnitKind = typeof decimalUnitKinds[number];\nexport type DecimalUnitOptions = {\n  kind: DecimalUnitKind;\n  decimal_places?: number;\n  abbreviate?: boolean;\n};\nexport const PERCENT_GROUP_CONFIG: UnitGroupConfig = {\n  label: 'Percent',\n  decimal_places: true,\n};\nexport const DECIMAL_UNIT_CONFIG: Readonly<Record<DecimalUnitKind, UnitConfig>> = {\n  Decimal: {\n    group: 'Decimal',\n    label: 'Decimal',\n  },\n};\n\nexport function formatDecimal(value: number, unitOptions: DecimalUnitOptions): string {\n  const decimals = unitOptions.decimal_places ?? DEFAULT_DECIMAL_PLACES;\n\n  if (unitOptions.abbreviate === true) {\n    return abbreviateLargeNumber(value, decimals);\n  }\n\n  const formatParams: Intl.NumberFormatOptions = {\n    style: 'decimal',\n    minimumFractionDigits: decimals,\n    maximumFractionDigits: decimals,\n    useGrouping: true,\n  };\n  const decimalFormatter = new Intl.NumberFormat('en-US', formatParams);\n  return decimalFormatter.format(value);\n}\n\n/**\n * Takes large numbers and abbreviates them with the appropriate suffix\n * 10123 -> 10.123k\n * 1000000 -> 1M\n */\nexport function abbreviateLargeNumber(num: number, decimals = 2) {\n  const modifier = (n: number) => round(n, decimals);\n  return formatNumber(num, modifier);\n}\n\n/**\n * Takes large numbers, rounds and abbreviates them with the appropriate suffix\n * Add modifier to run on output value prior to unit being added (defaults to rounding)\n */\nexport function formatNumber(num: number, modifier?: (n: number) => number): string {\n  const fn = modifier ?? Math.round;\n\n  return num >= 1e12\n    ? fn(num / 1e12) + 'T'\n    : num >= 1e9\n    ? fn(num / 1e9) + 'B'\n    : num >= 1e6\n    ? fn(num / 1e6) + 'M'\n    : num >= 1e3\n    ? fn(num / 1e3) + 'K'\n    : num.toString();\n}\n"],"names":["round","DEFAULT_DECIMAL_PLACES","decimalUnitKinds","PERCENT_GROUP_CONFIG","label","decimal_places","DECIMAL_UNIT_CONFIG","Decimal","group","formatDecimal","value","unitOptions","decimals","abbreviate","abbreviateLargeNumber","formatParams","style","minimumFractionDigits","maximumFractionDigits","useGrouping","decimalFormatter","Intl","NumberFormat","format","num","modifier","n","formatNumber","fn","Math","toString"],"mappings":"AAAA,oCAAoC;AACpC,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,6CAA6C;AAC7C,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,SAASA,KAAK,QAAQ,oBAAoB,CAAC;AAC3C,SAASC,sBAAsB,QAAQ,aAAa,CAAC;AAGrD,MAAMC,gBAAgB,GAAG;IAAC,SAAS;CAAC,AAAS,AAAC;AAO9C,OAAO,MAAMC,oBAAoB,GAAoB;IACnDC,KAAK,EAAE,SAAS;IAChBC,cAAc,EAAE,IAAI;CACrB,CAAC;AACF,OAAO,MAAMC,mBAAmB,GAAkD;IAChFC,OAAO,EAAE;QACPC,KAAK,EAAE,SAAS;QAChBJ,KAAK,EAAE,SAAS;KACjB;CACF,CAAC;AAEF,OAAO,SAASK,aAAa,CAACC,KAAa,EAAEC,WAA+B,EAAU;QACnEA,eAA0B;IAA3C,MAAMC,QAAQ,GAAGD,CAAAA,eAA0B,GAA1BA,WAAW,CAACN,cAAc,cAA1BM,eAA0B,cAA1BA,eAA0B,GAAIV,sBAAsB,AAAC;IAEtE,IAAIU,WAAW,CAACE,UAAU,KAAK,IAAI,EAAE;QACnC,OAAOC,qBAAqB,CAACJ,KAAK,EAAEE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED,MAAMG,YAAY,GAA6B;QAC7CC,KAAK,EAAE,SAAS;QAChBC,qBAAqB,EAAEL,QAAQ;QAC/BM,qBAAqB,EAAEN,QAAQ;QAC/BO,WAAW,EAAE,IAAI;KAClB,AAAC;IACF,MAAMC,gBAAgB,GAAG,IAAIC,IAAI,CAACC,YAAY,CAAC,OAAO,EAAEP,YAAY,CAAC,AAAC;IACtE,OAAOK,gBAAgB,CAACG,MAAM,CAACb,KAAK,CAAC,CAAC;AACxC,CAAC;AAED;;;;CAIC,GACD,OAAO,SAASI,qBAAqB,CAACU,GAAW,EAAEZ,QAAQ,GAAG,CAAC,EAAE;IAC/D,MAAMa,QAAQ,GAAG,CAACC,CAAS,GAAK1B,KAAK,CAAC0B,CAAC,EAAEd,QAAQ,CAAC,AAAC;IACnD,OAAOe,YAAY,CAACH,GAAG,EAAEC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED;;;CAGC,GACD,OAAO,SAASE,YAAY,CAACH,GAAW,EAAEC,QAAgC,EAAU;IAClF,MAAMG,EAAE,GAAGH,QAAQ,aAARA,QAAQ,cAARA,QAAQ,GAAII,IAAI,CAAC7B,KAAK,AAAC;IAElC,OAAOwB,GAAG,IAAI,IAAI,GACdI,EAAE,CAACJ,GAAG,GAAG,IAAI,CAAC,GAAG,GAAG,GACpBA,GAAG,IAAI,GAAG,GACVI,EAAE,CAACJ,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,GACnBA,GAAG,IAAI,GAAG,GACVI,EAAE,CAACJ,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,GACnBA,GAAG,IAAI,GAAG,GACVI,EAAE,CAACJ,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,GACnBA,GAAG,CAACM,QAAQ,EAAE,CAAC;AACrB,CAAC"}

package/dist/model/units/index.d.ts

@@ -0,0 +1,4 @@
+export * from './units';
+export * from './constants';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/model/units/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/model/units/index.ts"],"names":[],"mappings":"AAaA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}