@perses-dev/core 0.37.2 → 0.39.0

package/dist/cjs/model/calculations.js

@@ -23,7 +23,6 @@ function _export(target, all) {
 _export(exports, {
     CalculationsMap: ()=>CalculationsMap,
     CALCULATIONS_CONFIG: ()=>CALCULATIONS_CONFIG,
-    DEFAULT_CALCULATION: ()=>DEFAULT_CALCULATION,
     getCalculations: ()=>getCalculations,
     getCalculation: ()=>getCalculation
 });
@@ -71,7 +70,6 @@ const CALCULATIONS_CONFIG = {
         description: 'Maximum value'
     }
 };
-const DEFAULT_CALCULATION = 'Sum';
 function getCalculations(values, includeCalculations) {
     const calculations = includeCalculations.reduce((initResult, calculation)=>{
         initResult[calculation] = undefined;

package/dist/cjs/model/index.js

@@ -24,6 +24,7 @@ _exportStar(require("./layout"), exports);
 _exportStar(require("./legend"), exports);
 _exportStar(require("./notice"), exports);
 _exportStar(require("./panels"), exports);
+_exportStar(require("./project"), exports);
 _exportStar(require("./query"), exports);
 _exportStar(require("./resource"), exports);
 _exportStar(require("./thresholds"), exports);

package/dist/cjs/model/project.js

@@ -0,0 +1,16 @@
+// 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
+});

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

@@ -33,7 +33,13 @@ function _interopRequireDefault(obj) {
         default: obj
     };
 }
-const DEFAULT_NUMBRO_MANTISSA = 2;
+/**
+ * We consider the units for bytes to be powers of 1000.
+ * In other words:
+ * 1 KB = 1000 bytes (1000^1 bytes)
+ * 1 MB = 1,000,000 bytes (1000^2 bytes)
+ * etc.
+ */ const DEFAULT_NUMBRO_MANTISSA = 2;
 const bytesUnitKinds = [
     'Bytes'
 ];
@@ -43,15 +49,13 @@ const BYTES_GROUP_CONFIG = {
     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;
+function formatBytes(bytes, { abbreviate , decimal_places  }) {
+    // If we're showing the entire value, we can use Intl.NumberFormat.
     if (!(0, _utils.shouldAbbreviate)(abbreviate) || Math.abs(bytes) < 1000) {
         const formatterOptions = {
             style: 'unit',
@@ -68,9 +72,11 @@ function formatBytes(bytes, options) {
                 formatterOptions.maximumSignificantDigits = _constants.MAX_SIGNIFICANT_DIGITS;
             }
         }
-        return Intl.NumberFormat('en-US', formatterOptions).format(bytes);
+        const formatter = Intl.NumberFormat('en-US', formatterOptions);
+        return formatter.format(bytes);
     }
-    // numbro is able to add units like KB, MB, GB, etc. correctly
+    // If we're showing the "abbreviated" value, we use numbro.
+    // numbro is able to add units like KB, MB, GB, etc. correctly.
     return (0, _numbro.default)(bytes).format({
         output: 'byte',
         base: 'decimal',

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

@@ -41,8 +41,7 @@ const DECIMAL_UNIT_CONFIG = {
         label: 'Decimal'
     }
 };
-function formatDecimal(value, options) {
-    const { abbreviate , decimal_places  } = options;
+function formatDecimal(value, { abbreviate , decimal_places  }) {
     const formatterOptions = {
         style: 'decimal',
         useGrouping: true
@@ -58,5 +57,6 @@ function formatDecimal(value, options) {
             formatterOptions.maximumSignificantDigits = _constants.MAX_SIGNIFICANT_DIGITS;
         }
     }
-    return Intl.NumberFormat('en-US', formatterOptions).format(value);
+    const formatter = Intl.NumberFormat('en-US', formatterOptions);
+    return formatter.format(value);
 }

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

@@ -55,10 +55,6 @@ const PERCENT_UNIT_CONFIG = {
     }
 };
 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
@@ -69,5 +65,10 @@ function formatPercent(value, { kind , decimal_places  }) {
     } else {
         formatterOptions.maximumSignificantDigits = _constants.MAX_SIGNIFICANT_DIGITS;
     }
-    return Intl.NumberFormat('en-US', formatterOptions).format(value);
+    // Intl.NumberFormat translates 0 -> 0%, 0.5 -> 50%, 1 -> 100%, etc.
+    if (kind === 'Percent') {
+        value = value / 100;
+    }
+    const formatter = Intl.NumberFormat('en-US', formatterOptions);
+    return formatter.format(value);
 }

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

@@ -88,12 +88,64 @@ var PersesTimeToIntlTime;
     PersesTimeToIntlTime["Months"] = 'month';
     PersesTimeToIntlTime["Years"] = 'year';
 })(PersesTimeToIntlTime || (PersesTimeToIntlTime = {}));
+/**
+ * Note: This conversion will not be exactly accurate for months and years,
+ * due variations in the lengths of months (i.e. 28 - 31 days) and years (i.e. leap years).
+ * For precision with months and years, we would need more complex algorithms and/or external libraries.
+ * However, we expect that measurements in months and years will be rare.
+ */ const TIME_UNITS_IN_SECONDS = {
+    Years: 31536000,
+    Months: 2592000,
+    Weeks: 604800,
+    Days: 86400,
+    Hours: 3600,
+    Minutes: 60,
+    Seconds: 1,
+    Milliseconds: 0.001
+};
+const LARGEST_TO_SMALLEST_TIME_UNITS = [
+    'Years',
+    'Months',
+    'Weeks',
+    'Days',
+    'Hours',
+    'Minutes',
+    'Seconds',
+    'Milliseconds'
+];
+/**
+ * Choose the first time unit that produces a number greater than 1, starting from the biggest time unit.
+ */ function getValueAndKindForNaturalNumbers(value, kind) {
+    const valueInSeconds = value * TIME_UNITS_IN_SECONDS[kind];
+    // Initialize for TS
+    const largestTimeUnit = LARGEST_TO_SMALLEST_TIME_UNITS[0] || 'Years';
+    let timeUnit = largestTimeUnit;
+    let valueInTimeUnit = valueInSeconds / TIME_UNITS_IN_SECONDS[largestTimeUnit];
+    for (timeUnit of LARGEST_TO_SMALLEST_TIME_UNITS){
+        valueInTimeUnit = valueInSeconds / TIME_UNITS_IN_SECONDS[timeUnit];
+        if (valueInTimeUnit >= 1) {
+            return {
+                value: valueInTimeUnit,
+                kind: timeUnit
+            };
+        }
+    }
+    // If we didn't find a time unit, we have to settle for the smallest time unit (which is the last time unit).
+    return {
+        value: valueInTimeUnit,
+        kind: timeUnit
+    };
+}
+function isMonthOrYear(kind) {
+    return kind === 'Months' || kind === 'Years';
+}
 function formatTime(value, { kind , decimal_places  }) {
-    const isMonthOrYear = kind === 'Months' || kind === 'Years';
+    if (value === 0) return '0s';
+    const results = getValueAndKindForNaturalNumbers(value, kind);
     const formatterOptions = {
         style: 'unit',
-        unit: PersesTimeToIntlTime[kind],
-        unitDisplay: isMonthOrYear ? 'long' : 'narrow'
+        unit: PersesTimeToIntlTime[results.kind],
+        unitDisplay: isMonthOrYear(results.kind) ? 'long' : 'narrow'
     };
     if ((0, _utils.hasDecimalPlaces)(decimal_places)) {
         formatterOptions.minimumFractionDigits = (0, _utils.limitDecimalPlaces)(decimal_places);
@@ -101,5 +153,6 @@ function formatTime(value, { kind , decimal_places  }) {
     } else {
         formatterOptions.maximumSignificantDigits = _constants.MAX_SIGNIFICANT_DIGITS;
     }
-    return Intl.NumberFormat('en-US', formatterOptions).format(value);
+    const formatter = Intl.NumberFormat('en-US', formatterOptions);
+    return formatter.format(results.value);
 }

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

@@ -54,17 +54,17 @@ function formatValue(value, unitOptions) {
     if (unitOptions === undefined) {
         return value.toString();
     }
+    if (isBytesUnit(unitOptions)) {
+        return (0, _bytes.formatBytes)(value, unitOptions);
+    }
     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);
+    if (isTimeUnit(unitOptions)) {
+        return (0, _time.formatTime)(value, unitOptions);
     }
     const exhaustive = unitOptions;
     throw new Error(`Unknown unit options ${exhaustive}`);

package/dist/cjs/utils/text.js

@@ -21,17 +21,45 @@ function _export(target, all) {
     });
 }
 _export(exports, {
-    dashboardDisplayName: ()=>dashboardDisplayName,
-    dashboardExtendedDisplayName: ()=>dashboardExtendedDisplayName
+    getDashboardDisplayName: ()=>getDashboardDisplayName,
+    getVariableDisplayName: ()=>getVariableDisplayName,
+    getDatasourceDisplayName: ()=>getDatasourceDisplayName,
+    getDashboardExtendedDisplayName: ()=>getDashboardExtendedDisplayName,
+    getVariableExtendedDisplayName: ()=>getVariableExtendedDisplayName,
+    getDatasourceExtendedDisplayName: ()=>getDatasourceExtendedDisplayName
 });
-function dashboardDisplayName(dashboard) {
+function getDashboardDisplayName(dashboard) {
     var ref;
-    return ((ref = dashboard.spec.display) === null || ref === void 0 ? void 0 : ref.name) || dashboard.metadata.name;
+    var ref1;
+    return (ref1 = (ref = dashboard.spec.display) === null || ref === void 0 ? void 0 : ref.name) !== null && ref1 !== void 0 ? ref1 : dashboard.metadata.name;
 }
-function dashboardExtendedDisplayName(dashboard) {
+function getVariableDisplayName(variable) {
+    var ref;
+    var ref1;
+    return (ref1 = (ref = variable.spec.spec.display) === null || ref === void 0 ? void 0 : ref.name) !== null && ref1 !== void 0 ? ref1 : variable.metadata.name;
+}
+function getDatasourceDisplayName(datasource) {
+    var ref;
+    return ((ref = datasource.spec.display) === null || ref === void 0 ? void 0 : ref.name) || datasource.metadata.name;
+}
+function getDashboardExtendedDisplayName(dashboard) {
     var ref;
     if ((ref = dashboard.spec.display) === null || ref === void 0 ? void 0 : ref.name) {
-        return `${dashboard.spec.display.name} (ID: ${dashboard.metadata.name})`;
+        return `${dashboard.spec.display.name} (Name: ${dashboard.metadata.name})`;
     }
     return dashboard.metadata.name;
 }
+function getVariableExtendedDisplayName(variable) {
+    var ref;
+    if ((ref = variable.spec.spec.display) === null || ref === void 0 ? void 0 : ref.name) {
+        return `${variable.spec.spec.display.name} (Name: ${variable.metadata.name})`;
+    }
+    return variable.metadata.name;
+}
+function getDatasourceExtendedDisplayName(datasource) {
+    var ref;
+    if ((ref = datasource.spec.display) === null || ref === void 0 ? void 0 : ref.name) {
+        return `${datasource.spec.display.name} (ID: ${datasource.metadata.name})`;
+    }
+    return datasource.metadata.name;
+}

package/dist/model/calculations.d.ts

@@ -15,7 +15,6 @@ export declare type CalculationConfig = {
     description: string;
 };
 export declare const CALCULATIONS_CONFIG: Readonly<Record<CalculationType, CalculationConfig>>;
-export declare const DEFAULT_CALCULATION: CalculationType;
 declare type CalculationValue = number | null | undefined;
 /**
  * Calculate a multiple values for a set of time series data.

package/dist/model/calculations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calculations.d.ts","sourceRoot":"","sources":["../../src/model/calculations.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,eAAO,MAAM,eAAe;;;;;;;;;CAS3B,CAAC;AAEF,oBAAY,eAAe,GAAG,MAAM,OAAO,eAAe,CAAC;AAE3D,oBAAY,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAiC3E,CAAC;AAEX,eAAO,MAAM,mBAAmB,EAAE,eAAuB,CAAC;AAE1D,aAAK,gBAAgB,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,YAAY,SAAS,eAAe,EAAE,EACpE,MAAM,EAAE,oBAAoB,EAAE,EAC9B,mBAAmB,EAAE,YAAY,GAChC,MAAM,CAGP,OAAO,CAAC,eAAe,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,EAC9C,gBAAgB,CACjB,CA2EA;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,EAAE,EAAE,WAAW,EAAE,eAAe,oBAE1F;AAED,iBAAS,KAAK,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,gBAAgB,CAE/D;AAED,iBAAS,IAAI,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,gBAAgB,CAE9D;AAED,iBAAS,WAAW,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,gBAAgB,CAErE;AAED,iBAAS,UAAU,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,gBAAgB,CAEpE;AAED,iBAAS,IAAI,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,gBAAgB,CAE9D;AAED,iBAAS,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,gBAAgB,CAE7D;AAED,iBAAS,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,gBAAgB,CAE7D;AAED,iBAAS,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,gBAAgB,CAE7D"}
+{"version":3,"file":"calculations.d.ts","sourceRoot":"","sources":["../../src/model/calculations.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,eAAO,MAAM,eAAe;;;;;;;;;CAS3B,CAAC;AAEF,oBAAY,eAAe,GAAG,MAAM,OAAO,eAAe,CAAC;AAE3D,oBAAY,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAiC3E,CAAC;AAEX,aAAK,gBAAgB,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,YAAY,SAAS,eAAe,EAAE,EACpE,MAAM,EAAE,oBAAoB,EAAE,EAC9B,mBAAmB,EAAE,YAAY,GAChC,MAAM,CAGP,OAAO,CAAC,eAAe,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,EAC9C,gBAAgB,CACjB,CA2EA;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,EAAE,EAAE,WAAW,EAAE,eAAe,oBAE1F;AAED,iBAAS,KAAK,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,gBAAgB,CAE/D;AAED,iBAAS,IAAI,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,gBAAgB,CAE9D;AAED,iBAAS,WAAW,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,gBAAgB,CAErE;AAED,iBAAS,UAAU,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,gBAAgB,CAEpE;AAED,iBAAS,IAAI,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,gBAAgB,CAE9D;AAED,iBAAS,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,gBAAgB,CAE7D;AAED,iBAAS,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,gBAAgB,CAE7D;AAED,iBAAS,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,gBAAgB,CAE7D"}

package/dist/model/calculations.js

@@ -54,7 +54,6 @@ export const CALCULATIONS_CONFIG = {
         description: 'Maximum value'
     }
 };
-export const DEFAULT_CALCULATION = 'Sum';
 /**
  * Calculate a multiple values for a set of time series data.
  *

package/dist/model/calculations.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/model/calculations.ts"],"sourcesContent":["// Copyright 2023 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 { TimeSeriesValueTuple } from '@perses-dev/core';\n\nexport const CalculationsMap = {\n  First: first,\n  Last: last,\n  FirstNumber: firstNumber,\n  LastNumber: lastNumber,\n  Mean: mean,\n  Sum: sum,\n  Min: min,\n  Max: max,\n};\n\nexport type CalculationType = keyof typeof CalculationsMap;\n\nexport type CalculationConfig = {\n  label: string;\n  description: string;\n};\n\nexport const CALCULATIONS_CONFIG: Readonly<Record<CalculationType, CalculationConfig>> = {\n  First: {\n    label: 'First',\n    description: 'First value',\n  },\n  Last: {\n    label: 'Last',\n    description: 'Last value',\n  },\n  FirstNumber: {\n    label: 'First *',\n    description: 'First numeric value',\n  },\n  LastNumber: {\n    label: 'Last *',\n    description: 'Last numeric value',\n  },\n  Mean: {\n    label: 'Avg',\n    description: 'Average value excluding nulls',\n  },\n  Sum: {\n    label: 'Sum',\n    description: 'The sum of all values',\n  },\n  Min: {\n    label: 'Min',\n    description: 'Minimum value',\n  },\n  Max: {\n    label: 'Max',\n    description: 'Maximum value',\n  },\n} as const;\n\nexport const DEFAULT_CALCULATION: CalculationType = 'Sum';\n\ntype CalculationValue = number | null | undefined;\n\n/**\n * Calculate a multiple values for a set of time series data.\n *\n * @param values - Array of time series data.\n * @param includeCalculations - Array of calculations to include.\n */\nexport function getCalculations<IncludeCalcs extends CalculationType[]>(\n  values: TimeSeriesValueTuple[],\n  includeCalculations: IncludeCalcs\n): Record<\n  // This extract combined with the generics above keeps the key of the returned\n  // record to *just* the specified calculations.\n  Extract<CalculationType, IncludeCalcs[number]>,\n  CalculationValue\n> {\n  const calculations = includeCalculations.reduce((initResult, calculation) => {\n    initResult[calculation] = undefined;\n    return initResult;\n  }, {} as Record<string, CalculationValue>);\n\n  // We save these values as separate values instead of directly setting them\n  // in the calculations because they are needed by multiple calculations.\n  let nonNullCount = 0;\n  let sum = 0;\n\n  // We use this large function capable of performing one or more calculations\n  // in a single iteration of the data to minimize the performance impact of\n  // generating multiple calculations for large timeseries values. This is\n  // less optimized for certain single calculations when done in isolation (e.g.\n  // `Last`), but will be more performant in the more expensive cases where\n  // multiple values are being used (e.g. table legend).\n  values.forEach((tuple, i) => {\n    const value = tuple[1];\n\n    if (i === 0 && 'First' in calculations) {\n      calculations.First = value;\n    }\n    if (i === values.length - 1 && 'Last' in calculations) {\n      calculations.Last = value;\n    }\n\n    // Handling specific to non-null values.\n    if (typeof value === 'number') {\n      nonNullCount += 1;\n      sum += value;\n\n      if ('FirstNumber' in calculations && calculations.FirstNumber === undefined) {\n        // Save the first number we see.\n        calculations.FirstNumber = value;\n      }\n\n      if ('LastNumber' in calculations) {\n        // Keep setting the numbers we see, which will eventually be set to the\n        // last number when finished iterating.\n        calculations.LastNumber = value;\n      }\n\n      if ('Min' in calculations) {\n        if (typeof calculations.Min !== 'number') {\n          // Init the first time we see a number\n          calculations.Min = value;\n        } else {\n          // Use lowest value once initialized\n          calculations.Min = Math.min(calculations.Min, value);\n        }\n      }\n\n      if ('Max' in calculations) {\n        if (typeof calculations.Max !== 'number') {\n          // Init the first time we see a number\n          calculations.Max = value;\n        } else {\n          // Use highest value once initialized\n          calculations.Max = Math.max(calculations.Max, value);\n        }\n      }\n    }\n  });\n\n  // Set calculations that require iterating over all values.\n  if (nonNullCount > 0 && 'Sum' in calculations) {\n    calculations.Sum = sum;\n  }\n\n  if (nonNullCount > 0 && 'Mean' in calculations) {\n    calculations.Mean = sum / nonNullCount;\n  }\n\n  return calculations;\n}\n\n/**\n * Calculate a single value for a set of time series data.\n *\n * Use `getCalculations` instead if you need multiple calculations.\n *\n * @param values - Array of time series data.\n * @param calculation - Name of the calculation to calculate.\n */\nexport function getCalculation(values: TimeSeriesValueTuple[], calculation: CalculationType) {\n  return getCalculations(values, [calculation])[calculation];\n}\n\nfunction first(values: TimeSeriesValueTuple[]): CalculationValue {\n  return getCalculation(values, 'First');\n}\n\nfunction last(values: TimeSeriesValueTuple[]): CalculationValue {\n  return getCalculation(values, 'Last');\n}\n\nfunction firstNumber(values: TimeSeriesValueTuple[]): CalculationValue {\n  return getCalculation(values, 'FirstNumber');\n}\n\nfunction lastNumber(values: TimeSeriesValueTuple[]): CalculationValue {\n  return getCalculation(values, 'LastNumber');\n}\n\nfunction mean(values: TimeSeriesValueTuple[]): CalculationValue {\n  return getCalculation(values, 'Mean');\n}\n\nfunction sum(values: TimeSeriesValueTuple[]): CalculationValue {\n  return getCalculation(values, 'Sum');\n}\n\nfunction min(values: TimeSeriesValueTuple[]): CalculationValue {\n  return getCalculation(values, 'Min');\n}\n\nfunction max(values: TimeSeriesValueTuple[]): CalculationValue {\n  return getCalculation(values, 'Max');\n}\n"],"names":["CalculationsMap","First","first","Last","last","FirstNumber","firstNumber","LastNumber","lastNumber","Mean","mean","Sum","sum","Min","min","Max","max","CALCULATIONS_CONFIG","label","description","DEFAULT_CALCULATION","getCalculations","values","includeCalculations","calculations","reduce","initResult","calculation","undefined","nonNullCount","forEach","tuple","i","value","length","Math","getCalculation"],"mappings":"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"}
+{"version":3,"sources":["../../src/model/calculations.ts"],"sourcesContent":["// Copyright 2023 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 { TimeSeriesValueTuple } from '@perses-dev/core';\n\nexport const CalculationsMap = {\n  First: first,\n  Last: last,\n  FirstNumber: firstNumber,\n  LastNumber: lastNumber,\n  Mean: mean,\n  Sum: sum,\n  Min: min,\n  Max: max,\n};\n\nexport type CalculationType = keyof typeof CalculationsMap;\n\nexport type CalculationConfig = {\n  label: string;\n  description: string;\n};\n\nexport const CALCULATIONS_CONFIG: Readonly<Record<CalculationType, CalculationConfig>> = {\n  First: {\n    label: 'First',\n    description: 'First value',\n  },\n  Last: {\n    label: 'Last',\n    description: 'Last value',\n  },\n  FirstNumber: {\n    label: 'First *',\n    description: 'First numeric value',\n  },\n  LastNumber: {\n    label: 'Last *',\n    description: 'Last numeric value',\n  },\n  Mean: {\n    label: 'Avg',\n    description: 'Average value excluding nulls',\n  },\n  Sum: {\n    label: 'Sum',\n    description: 'The sum of all values',\n  },\n  Min: {\n    label: 'Min',\n    description: 'Minimum value',\n  },\n  Max: {\n    label: 'Max',\n    description: 'Maximum value',\n  },\n} as const;\n\ntype CalculationValue = number | null | undefined;\n\n/**\n * Calculate a multiple values for a set of time series data.\n *\n * @param values - Array of time series data.\n * @param includeCalculations - Array of calculations to include.\n */\nexport function getCalculations<IncludeCalcs extends CalculationType[]>(\n  values: TimeSeriesValueTuple[],\n  includeCalculations: IncludeCalcs\n): Record<\n  // This extract combined with the generics above keeps the key of the returned\n  // record to *just* the specified calculations.\n  Extract<CalculationType, IncludeCalcs[number]>,\n  CalculationValue\n> {\n  const calculations = includeCalculations.reduce((initResult, calculation) => {\n    initResult[calculation] = undefined;\n    return initResult;\n  }, {} as Record<string, CalculationValue>);\n\n  // We save these values as separate values instead of directly setting them\n  // in the calculations because they are needed by multiple calculations.\n  let nonNullCount = 0;\n  let sum = 0;\n\n  // We use this large function capable of performing one or more calculations\n  // in a single iteration of the data to minimize the performance impact of\n  // generating multiple calculations for large timeseries values. This is\n  // less optimized for certain single calculations when done in isolation (e.g.\n  // `Last`), but will be more performant in the more expensive cases where\n  // multiple values are being used (e.g. table legend).\n  values.forEach((tuple, i) => {\n    const value = tuple[1];\n\n    if (i === 0 && 'First' in calculations) {\n      calculations.First = value;\n    }\n    if (i === values.length - 1 && 'Last' in calculations) {\n      calculations.Last = value;\n    }\n\n    // Handling specific to non-null values.\n    if (typeof value === 'number') {\n      nonNullCount += 1;\n      sum += value;\n\n      if ('FirstNumber' in calculations && calculations.FirstNumber === undefined) {\n        // Save the first number we see.\n        calculations.FirstNumber = value;\n      }\n\n      if ('LastNumber' in calculations) {\n        // Keep setting the numbers we see, which will eventually be set to the\n        // last number when finished iterating.\n        calculations.LastNumber = value;\n      }\n\n      if ('Min' in calculations) {\n        if (typeof calculations.Min !== 'number') {\n          // Init the first time we see a number\n          calculations.Min = value;\n        } else {\n          // Use lowest value once initialized\n          calculations.Min = Math.min(calculations.Min, value);\n        }\n      }\n\n      if ('Max' in calculations) {\n        if (typeof calculations.Max !== 'number') {\n          // Init the first time we see a number\n          calculations.Max = value;\n        } else {\n          // Use highest value once initialized\n          calculations.Max = Math.max(calculations.Max, value);\n        }\n      }\n    }\n  });\n\n  // Set calculations that require iterating over all values.\n  if (nonNullCount > 0 && 'Sum' in calculations) {\n    calculations.Sum = sum;\n  }\n\n  if (nonNullCount > 0 && 'Mean' in calculations) {\n    calculations.Mean = sum / nonNullCount;\n  }\n\n  return calculations;\n}\n\n/**\n * Calculate a single value for a set of time series data.\n *\n * Use `getCalculations` instead if you need multiple calculations.\n *\n * @param values - Array of time series data.\n * @param calculation - Name of the calculation to calculate.\n */\nexport function getCalculation(values: TimeSeriesValueTuple[], calculation: CalculationType) {\n  return getCalculations(values, [calculation])[calculation];\n}\n\nfunction first(values: TimeSeriesValueTuple[]): CalculationValue {\n  return getCalculation(values, 'First');\n}\n\nfunction last(values: TimeSeriesValueTuple[]): CalculationValue {\n  return getCalculation(values, 'Last');\n}\n\nfunction firstNumber(values: TimeSeriesValueTuple[]): CalculationValue {\n  return getCalculation(values, 'FirstNumber');\n}\n\nfunction lastNumber(values: TimeSeriesValueTuple[]): CalculationValue {\n  return getCalculation(values, 'LastNumber');\n}\n\nfunction mean(values: TimeSeriesValueTuple[]): CalculationValue {\n  return getCalculation(values, 'Mean');\n}\n\nfunction sum(values: TimeSeriesValueTuple[]): CalculationValue {\n  return getCalculation(values, 'Sum');\n}\n\nfunction min(values: TimeSeriesValueTuple[]): CalculationValue {\n  return getCalculation(values, 'Min');\n}\n\nfunction max(values: TimeSeriesValueTuple[]): CalculationValue {\n  return getCalculation(values, 'Max');\n}\n"],"names":["CalculationsMap","First","first","Last","last","FirstNumber","firstNumber","LastNumber","lastNumber","Mean","mean","Sum","sum","Min","min","Max","max","CALCULATIONS_CONFIG","label","description","getCalculations","values","includeCalculations","calculations","reduce","initResult","calculation","undefined","nonNullCount","forEach","tuple","i","value","length","Math","getCalculation"],"mappings":"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"}

package/dist/model/datasource.d.ts

@@ -10,7 +10,7 @@ export interface GlobalDatasource {
     spec: DatasourceSpec;
 }
 /**
- * A Datasource that belongs to a project.
+ * A Datasource resource, that belongs to a project.
  */
 export interface Datasource {
     kind: 'Datasource';

package/dist/model/datasource.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/model/datasource.ts"],"sourcesContent":["// Copyright 2023 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 { Definition, UnknownSpec } from './definitions';\nimport { Metadata, ProjectMetadata } from './resource';\nimport { Display } from './display';\n\n/**\n * A Datasource that's available across all projects.\n */\nexport interface GlobalDatasource {\n  kind: 'GlobalDatasource';\n  metadata: Metadata;\n  spec: DatasourceSpec;\n}\n\n/**\n * A Datasource that belongs to a project.\n */\nexport interface Datasource {\n  kind: 'Datasource';\n  metadata: ProjectMetadata;\n  spec: DatasourceSpec;\n}\n\nexport interface DatasourceSpec<PluginSpec = UnknownSpec> {\n  display?: Display;\n  default: boolean;\n  plugin: Definition<PluginSpec>;\n}\n\n/**\n * A selector for pointing at a specific Datasource. If name is omitted, it's assumed that you want the default\n * Datasource for the specified kind.\n */\nexport interface DatasourceSelector {\n  kind: string;\n  name?: string;\n}\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,WAmCC"}
+{"version":3,"sources":["../../src/model/datasource.ts"],"sourcesContent":["// Copyright 2023 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 { Definition, UnknownSpec } from './definitions';\nimport { Metadata, ProjectMetadata } from './resource';\nimport { Display } from './display';\n\n/**\n * A Datasource that's available across all projects.\n */\nexport interface GlobalDatasource {\n  kind: 'GlobalDatasource';\n  metadata: Metadata;\n  spec: DatasourceSpec;\n}\n\n/**\n * A Datasource resource, that belongs to a project.\n */\nexport interface Datasource {\n  kind: 'Datasource';\n  metadata: ProjectMetadata;\n  spec: DatasourceSpec;\n}\n\nexport interface DatasourceSpec<PluginSpec = UnknownSpec> {\n  display?: Display;\n  default: boolean;\n  plugin: Definition<PluginSpec>;\n}\n\n/**\n * A selector for pointing at a specific Datasource. If name is omitted, it's assumed that you want the default\n * Datasource for the specified kind.\n */\nexport interface DatasourceSelector {\n  kind: string;\n  name?: string;\n}\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,WAmCC"}

package/dist/model/index.d.ts

@@ -8,6 +8,7 @@ export * from './layout';
 export * from './legend';
 export * from './notice';
 export * from './panels';
+export * from './project';
 export * from './query';
 export * from './resource';
 export * from './thresholds';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/model/index.ts"],"names":[],"mappings":"AAaA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/model/index.ts"],"names":[],"mappings":"AAaA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/dist/model/index.js

@@ -20,6 +20,7 @@ export * from './layout';
 export * from './legend';
 export * from './notice';
 export * from './panels';
+export * from './project';
 export * from './query';
 export * from './resource';
 export * from './thresholds';

package/dist/model/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/model/index.ts"],"sourcesContent":["// Copyright 2023 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 './calculations';\nexport * from './dashboard';\nexport * from './datasource';\nexport * from './definitions';\nexport * from './display';\nexport * from './http';\nexport * from './layout';\nexport * from './legend';\nexport * from './notice';\nexport * from './panels';\nexport * from './query';\nexport * from './resource';\nexport * from './thresholds';\nexport * from './time';\nexport * from './time-series-data';\nexport * from './time-series-queries';\nexport * from './units';\nexport * from './variables';\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,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}
+{"version":3,"sources":["../../src/model/index.ts"],"sourcesContent":["// Copyright 2023 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 './calculations';\nexport * from './dashboard';\nexport * from './datasource';\nexport * from './definitions';\nexport * from './display';\nexport * from './http';\nexport * from './layout';\nexport * from './legend';\nexport * from './notice';\nexport * from './panels';\nexport * from './project';\nexport * from './query';\nexport * from './resource';\nexport * from './thresholds';\nexport * from './time';\nexport * from './time-series-data';\nexport * from './time-series-queries';\nexport * from './units';\nexport * from './variables';\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,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/dist/model/project.d.ts

@@ -0,0 +1,6 @@
+import { Metadata } from './resource';
+export interface ProjectResource {
+    kind: 'Project';
+    metadata: Metadata;
+}
+//# sourceMappingURL=project.d.ts.map

package/dist/model/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/model/project.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;CACpB"}

package/dist/model/project.js

@@ -0,0 +1,15 @@
+// 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.
+export { };
+
+//# sourceMappingURL=project.js.map

package/dist/model/project.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/model/project.ts"],"sourcesContent":["// Copyright 2023 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 { Metadata } from './resource';\n\nexport interface ProjectResource {\n  kind: 'Project';\n  metadata: Metadata;\n}\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,WAKC"}

package/dist/model/query.d.ts

@@ -1,14 +1,25 @@
 import { Definition, UnknownSpec } from './definitions';
+import { TimeSeriesData } from './time-series-data';
 interface QuerySpec<PluginSpec> {
     plugin: Definition<PluginSpec>;
 }
 /**
  * A generic query definition interface that can be extended to support more than just TimeSeriesQuery
  */
-export interface QueryDefinition<Kind = QueryType, PluginSpec = UnknownSpec> {
+export interface QueryDefinition<Kind = any, PluginSpec = UnknownSpec> {
     kind: Kind;
     spec: QuerySpec<PluginSpec>;
 }
-export declare type QueryType = 'TimeSeriesQuery';
+/**
+ * Mapping the query plugin to the data type it returns
+ */
+export interface QueryType {
+    TimeSeriesQuery: TimeSeriesData;
+}
+/**
+ * Values of QueryType
+ * ex: 'TimeSeriesData'
+ */
+export declare type QueryDataType = QueryType[keyof QueryType];
 export {};
 //# sourceMappingURL=query.d.ts.map

package/dist/model/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/model/query.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAExD,UAAU,SAAS,CAAC,UAAU;IAC5B,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;CAChC;AACD;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,IAAI,GAAG,SAAS,EAAE,UAAU,GAAG,WAAW;IACzE,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;CAC7B;AAED,oBAAY,SAAS,GAAG,iBAAiB,CAAC"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/model/query.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,UAAU,SAAS,CAAC,UAAU;IAC5B,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;CAChC;AACD;;GAEG;AAGH,MAAM,WAAW,eAAe,CAAC,IAAI,GAAG,GAAG,EAAE,UAAU,GAAG,WAAW;IACnE,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,eAAe,EAAE,cAAc,CAAC;CAGjC;AAED;;;GAGG;AACH,oBAAY,aAAa,GAAG,SAAS,CAAC,MAAM,SAAS,CAAC,CAAC"}

package/dist/model/query.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/model/query.ts"],"sourcesContent":["// Copyright 2023 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 { Definition, UnknownSpec } from './definitions';\n\ninterface QuerySpec<PluginSpec> {\n  plugin: Definition<PluginSpec>;\n}\n/**\n * A generic query definition interface that can be extended to support more than just TimeSeriesQuery\n */\nexport interface QueryDefinition<Kind = QueryType, PluginSpec = UnknownSpec> {\n  kind: Kind;\n  spec: QuerySpec<PluginSpec>;\n}\n\nexport type QueryType = 'TimeSeriesQuery';\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,WAa0C"}
+{"version":3,"sources":["../../src/model/query.ts"],"sourcesContent":["// Copyright 2023 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 { Definition, UnknownSpec } from './definitions';\nimport { TimeSeriesData } from './time-series-data';\n\ninterface QuerySpec<PluginSpec> {\n  plugin: Definition<PluginSpec>;\n}\n/**\n * A generic query definition interface that can be extended to support more than just TimeSeriesQuery\n */\n// Kind needs to be `any` because otherwise typescript will complain 'unknown' is not assignable to type '\"TimeSeriesQuery\"' in a few places\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface QueryDefinition<Kind = any, PluginSpec = UnknownSpec> {\n  kind: Kind;\n  spec: QuerySpec<PluginSpec>;\n}\n\n/**\n * Mapping the query plugin to the data type it returns\n */\nexport interface QueryType {\n  TimeSeriesQuery: TimeSeriesData;\n  // in the future we can add other query plugin and data types\n  // for example: we can add something like `LogsQuery: LogsData;`\n}\n\n/**\n * Values of QueryType\n * ex: 'TimeSeriesData'\n */\nexport type QueryDataType = QueryType[keyof QueryType];\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,WA6BuD"}

package/dist/model/time-series-data.d.ts

@@ -21,5 +21,11 @@ export interface TimeSeries {
 }
 export interface TimeSeriesMetadata {
     notices?: Notice[];
+    /**
+     * The raw query that is executed to generate this data.
+     * Useful when needing to inspect the query that was executed
+     * after variables and other context modifications have been applied.
+     */
+    executedQueryString?: string;
 }
 //# sourceMappingURL=time-series-data.d.ts.map

package/dist/model/time-series-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"time-series-data.d.ts","sourceRoot":"","sources":["../../src/model/time-series-data.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAErE,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB"}
+{"version":3,"file":"time-series-data.d.ts","sourceRoot":"","sources":["../../src/model/time-series-data.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAErE,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/model/time-series-data.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/model/time-series-data.ts"],"sourcesContent":["// Copyright 2023 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 { Notice } from './notice';\nimport { AbsoluteTimeRange } from './time';\nimport { Labels, TimeSeriesValueTuple } from './time-series-queries';\n\nexport interface TimeScale {\n  startMs: number;\n  endMs: number;\n  stepMs: number;\n  rangeMs: number;\n}\n\nexport interface TimeSeriesData {\n  timeRange?: AbsoluteTimeRange;\n  stepMs?: number;\n  series: TimeSeries[];\n  metadata?: TimeSeriesMetadata;\n}\n\nexport interface TimeSeries {\n  name: string;\n  values: TimeSeriesValueTuple[];\n  formattedName?: string;\n  labels?: Labels;\n}\n\nexport interface TimeSeriesMetadata {\n  notices?: Notice[];\n}\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,WA2BC"}
+{"version":3,"sources":["../../src/model/time-series-data.ts"],"sourcesContent":["// Copyright 2023 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 { Notice } from './notice';\nimport { AbsoluteTimeRange } from './time';\nimport { Labels, TimeSeriesValueTuple } from './time-series-queries';\n\nexport interface TimeScale {\n  startMs: number;\n  endMs: number;\n  stepMs: number;\n  rangeMs: number;\n}\n\nexport interface TimeSeriesData {\n  timeRange?: AbsoluteTimeRange;\n  stepMs?: number;\n  series: TimeSeries[];\n  metadata?: TimeSeriesMetadata;\n}\n\nexport interface TimeSeries {\n  name: string;\n  values: TimeSeriesValueTuple[];\n  formattedName?: string;\n  labels?: Labels;\n}\n\nexport interface TimeSeriesMetadata {\n  notices?: Notice[];\n\n  /**\n   * The raw query that is executed to generate this data.\n   * Useful when needing to inspect the query that was executed\n   * after variables and other context modifications have been applied.\n   */\n  executedQueryString?: string;\n}\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,WAkCC"}

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

@@ -8,6 +8,6 @@ export declare type BytesUnitOptions = {
 };
 export declare const BYTES_GROUP_CONFIG: UnitGroupConfig;
 export declare const BYTES_UNIT_CONFIG: Readonly<Record<BytesUnitKind, UnitConfig>>;
-export declare function formatBytes(bytes: number, options: BytesUnitOptions): string;
+export declare function formatBytes(bytes: number, { abbreviate, decimal_places }: BytesUnitOptions): string;
 export {};
 //# sourceMappingURL=bytes.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../../src/model/units/bytes.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKtD,QAAA,MAAM,cAAc,oBAAqB,CAAC;AAC1C,aAAK,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AACrD,oBAAY,gBAAgB,GAAG;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AACF,eAAO,MAAM,kBAAkB,EAAE,eAIhC,CAAC;AACF,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,CAOzE,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,UAmCnE"}
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../../src/model/units/bytes.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAatD,QAAA,MAAM,cAAc,oBAAqB,CAAC;AAC1C,aAAK,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AACrD,oBAAY,gBAAgB,GAAG;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AACF,eAAO,MAAM,kBAAkB,EAAE,eAIhC,CAAC;AACF,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,CAKzE,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,EAAE,gBAAgB,UAmC1F"}

package/dist/model/units/bytes.js

@@ -13,7 +13,13 @@
 import numbro from 'numbro';
 import { MAX_SIGNIFICANT_DIGITS } from './constants';
 import { hasDecimalPlaces, limitDecimalPlaces, shouldAbbreviate } from './utils';
-const DEFAULT_NUMBRO_MANTISSA = 2;
+/**
+ * We consider the units for bytes to be powers of 1000.
+ * In other words:
+ * 1 KB = 1000 bytes (1000^1 bytes)
+ * 1 MB = 1,000,000 bytes (1000^2 bytes)
+ * etc.
+ */ const DEFAULT_NUMBRO_MANTISSA = 2;
 const bytesUnitKinds = [
     'Bytes'
 ];
@@ -23,15 +29,13 @@ export const BYTES_GROUP_CONFIG = {
     abbreviate: true
 };
 export const BYTES_UNIT_CONFIG = {
-    // These units are powers of 1000.
-    // In other words, 1 KB = 1000 bytes.
     Bytes: {
         group: 'Bytes',
         label: 'Bytes'
     }
 };
-export function formatBytes(bytes, options) {
-    const { abbreviate , decimal_places  } = options;
+export function formatBytes(bytes, { abbreviate , decimal_places  }) {
+    // If we're showing the entire value, we can use Intl.NumberFormat.
     if (!shouldAbbreviate(abbreviate) || Math.abs(bytes) < 1000) {
         const formatterOptions = {
             style: 'unit',
@@ -48,9 +52,11 @@ export function formatBytes(bytes, options) {
                 formatterOptions.maximumSignificantDigits = MAX_SIGNIFICANT_DIGITS;
             }
         }
-        return Intl.NumberFormat('en-US', formatterOptions).format(bytes);
+        const formatter = Intl.NumberFormat('en-US', formatterOptions);
+        return formatter.format(bytes);
     }
-    // numbro is able to add units like KB, MB, GB, etc. correctly
+    // If we're showing the "abbreviated" value, we use numbro.
+    // numbro is able to add units like KB, MB, GB, etc. correctly.
     return numbro(bytes).format({
         output: 'byte',
         base: 'decimal',