@oneuptime/common 11.7.4 → 12.0.0

package/build/dist/Utils/Dashboard/ValueWidgetLayout.js

@@ -0,0 +1,276 @@
+/*
+ * Everything the dashboard Value widget needs in order to decide how big to
+ * draw itself, derived by arithmetic from the tile size the canvas reports.
+ *
+ * It lives here rather than in the renderer for the same reason
+ * ClockWidgetFormat.ts does: none of it needs a DOM, so it is unit-testable,
+ * and the renderer stays a straight translation of these numbers into inline
+ * styles. Measuring the rendered text instead would cost a second render on
+ * every resize frame — the exact re-measure flicker DashboardBaseComponent's
+ * constant edit-mode padding exists to avoid.
+ *
+ * The contract with the renderer is that EVERY optional row is drawn at the
+ * pixel height returned here, with `shrink-0`, so the stack sums to the
+ * content box by construction. Before this existed the value row was the only
+ * shrinkable flex item (Tailwind's `truncate` sets overflow:hidden, which
+ * zeroes a flex item's automatic minimum size), so the whole vertical deficit
+ * landed on the big number and its glyphs were sliced in half — or, in edit
+ * mode at the default 3x1 tile, clipped away entirely.
+ */
+/**
+ * Padding the widget chrome puts between the tile edge and the widget's own
+ * content box. DashboardBaseComponent draws every widget in a card with a 1px
+ * `border` and wraps the child in `padding: 12px`, widened to
+ * `28px 12px 12px 12px` in edit mode for the drag handle it overlays.
+ *
+ * The canvas hands each widget its OUTER tile size, so a sizer that skips this
+ * overstates the box by 26px (42px while editing). On the shipped 3x1 default
+ * that is around a third of the usable height, which is most of the reason the
+ * big number ended up sliced.
+ *
+ * ClockWidgetFormat.ts uses 24/24/40 for the same three constants — it is
+ * missing the card's 1px border. That is a separate (much smaller) bug; the
+ * clock keeps 4px of its own vertical breathing room which absorbs it, and
+ * correcting it there would churn 300 lines of unrelated tests.
+ */
+const VALUE_CHROME_HORIZONTAL_IN_PX = 26;
+const VALUE_CHROME_VERTICAL_IN_PX = 26;
+const VALUE_CHROME_VERTICAL_EDIT_MODE_IN_PX = 42;
+/** Breathing room kept inside the content box so text never sits flush. */
+const VALUE_HORIZONTAL_PADDING_IN_PX = 8;
+/**
+ * line-height on the value row. Inter's content area is 1.21em (typo ascender
+ * 0.96875 + descender 0.24121), so the previous 1.15 let glyphs paint outside
+ * their own line box and the row's clip shaved them. 1.25 keeps the ink inside
+ * the box the budget reserved for it.
+ */
+export const VALUE_LINE_HEIGHT_RATIO = 1.25;
+/** The unit suffix is drawn at this fraction of the value font size. */
+export const VALUE_UNIT_FONT_SCALE = 0.36;
+/**
+ * Advance width of one character, as a fraction of the font size. The value
+ * row is `tabular-nums`, so every digit has the same advance; `.` `,` `-` are
+ * narrower than 0.62em and the row also carries `letter-spacing: -0.03em`, so
+ * this over-estimates. That is the safe direction: the failure mode is a
+ * slightly smaller number rather than a clipped one.
+ */
+const VALUE_CHAR_WIDTH_RATIO = 0.62;
+const UNIT_CHAR_WIDTH_RATIO = 0.58;
+/** Title row: font clamped to this range, at line-height 1.5 plus `mb-0.5`. */
+const TITLE_FONT_HEIGHT_FRACTION = 0.11;
+const MIN_TITLE_FONT_SIZE_IN_PX = 11;
+const MAX_TITLE_FONT_SIZE_IN_PX = 14;
+const TITLE_LINE_HEIGHT_RATIO = 1.5;
+const TITLE_ROW_MARGIN_IN_PX = 2;
+/** Status row: the trend arrow, or the hovered point's timestamp. */
+const MIN_STATUS_FONT_SIZE_IN_PX = 10;
+const MAX_STATUS_FONT_SIZE_IN_PX = 12;
+const STATUS_LINE_HEIGHT_RATIO = 1.5;
+const STATUS_ROW_MARGIN_IN_PX = 2;
+/** Sparkline row: the chart plus the `mt-1` above it. */
+const SPARKLINE_HEIGHT_FRACTION = 0.18;
+const MIN_SPARKLINE_HEIGHT_IN_PX = 16;
+const MAX_SPARKLINE_HEIGHT_IN_PX = 28;
+const SPARKLINE_ROW_MARGIN_IN_PX = 4;
+const SPARKLINE_WIDTH_FRACTION = 0.6;
+const MIN_SPARKLINE_WIDTH_IN_PX = 32;
+const MAX_SPARKLINE_WIDTH_IN_PX = 120;
+export const MIN_VALUE_FONT_SIZE_IN_PX = 14;
+export const MAX_VALUE_FONT_SIZE_IN_PX = 96;
+/**
+ * Value-row heights we refuse to drop below in order to show an optional row.
+ * A Value widget exists to show one number; a title that shrinks the digits to
+ * the legibility floor has taken more than it is worth.
+ *
+ * Crossing either of these steps the font size — a row that appears has to
+ * take its height from somewhere. That step is deliberate and bounded (the
+ * number never goes below MIN_VALUE_FONT_SIZE_IN_PX and is never clipped);
+ * making it continuous would mean never showing a title on a short tile.
+ */
+const TITLE_GATE_VALUE_ROW_IN_PX = 26;
+const STATUS_GATE_VALUE_ROW_IN_PX = 40;
+/**
+ * Below this content width the title and the trend cannot share a line without
+ * both truncating to nothing, so the compact header is not offered.
+ */
+const COMPACT_HEADER_MIN_CONTENT_WIDTH_IN_PX = 180;
+/** The value row height at which the value font reaches its ceiling. */
+const MAX_VALUE_ROW_HEIGHT_IN_PX = MAX_VALUE_FONT_SIZE_IN_PX * VALUE_LINE_HEIGHT_RATIO;
+export var ValueWidgetStackMode;
+(function (ValueWidgetStackMode) {
+    /** Title, value, status and sparkline each on their own row. */
+    ValueWidgetStackMode["Column"] = "Column";
+    /** Title and status share one line above the value. */
+    ValueWidgetStackMode["Compact"] = "Compact";
+})(ValueWidgetStackMode || (ValueWidgetStackMode = {}));
+const clamp = (value, min, max) => {
+    return Math.max(Math.min(value, max), min);
+};
+export const getValueContentBox = (data) => {
+    const verticalChrome = data.isEditMode
+        ? VALUE_CHROME_VERTICAL_EDIT_MODE_IN_PX
+        : VALUE_CHROME_VERTICAL_IN_PX;
+    return {
+        widthInPx: Math.max(data.widthInPx - VALUE_CHROME_HORIZONTAL_IN_PX, 0),
+        heightInPx: Math.max(data.heightInPx - verticalChrome, 0),
+    };
+};
+export const getValueWidthInFontUnits = (data) => {
+    // The unit is preceded by a space, drawn at the unit size.
+    const unitChars = data.unitText.length > 0 ? data.unitText.length + 1 : 0;
+    return (data.valueText.length * VALUE_CHAR_WIDTH_RATIO +
+        unitChars * UNIT_CHAR_WIDTH_RATIO * VALUE_UNIT_FONT_SCALE);
+};
+const getWidthLimitedFontSizeInPx = (data) => {
+    const widthInFontUnits = getValueWidthInFontUnits({
+        valueText: data.valueText,
+        unitText: data.unitText,
+    });
+    if (widthInFontUnits <= 0) {
+        return MAX_VALUE_FONT_SIZE_IN_PX;
+    }
+    return data.widthBudgetInPx / widthInFontUnits;
+};
+export const getValueWidgetLayout = (data) => {
+    const contentBox = getValueContentBox(data);
+    const contentHeightInPx = contentBox.heightInPx;
+    const contentWidthInPx = contentBox.widthInPx;
+    const titleFontSizeInPx = clamp(contentHeightInPx * TITLE_FONT_HEIGHT_FRACTION, MIN_TITLE_FONT_SIZE_IN_PX, MAX_TITLE_FONT_SIZE_IN_PX);
+    const titleRowHeightInPx = titleFontSizeInPx * TITLE_LINE_HEIGHT_RATIO + TITLE_ROW_MARGIN_IN_PX;
+    const statusFontSizeInPx = clamp(contentHeightInPx * TITLE_FONT_HEIGHT_FRACTION, MIN_STATUS_FONT_SIZE_IN_PX, MAX_STATUS_FONT_SIZE_IN_PX);
+    const statusRowHeightInPx = statusFontSizeInPx * STATUS_LINE_HEIGHT_RATIO + STATUS_ROW_MARGIN_IN_PX;
+    const sparklineHeightInPx = clamp(contentHeightInPx * SPARKLINE_HEIGHT_FRACTION, MIN_SPARKLINE_HEIGHT_IN_PX, MAX_SPARKLINE_HEIGHT_IN_PX);
+    const sparklineRowHeightInPx = sparklineHeightInPx + SPARKLINE_ROW_MARGIN_IN_PX;
+    /*
+     * The trend arrow and the hovered point's timestamp share one slot, so a
+     * tile that could show either has to reserve it up front. Neither term
+     * depends on whether the cursor is on the chart — that is what makes the
+     * hover swap provably unable to move anything. The old layout claimed this
+     * and did not deliver it: the timestamp was unconstrained and wrapped.
+     */
+    const hasStatus = data.hasTrend || data.hasSparklineData;
+    /*
+     * A short tile stacks title / value / trend and runs out of height; putting
+     * the title and the trend on one line hands that height back to the number.
+     * The switch sits exactly where the stacked layout stops being able to keep
+     * the value at its ceiling, so crossing it cannot change the rendered font
+     * size: below it the compact value row is still at least MAX_VALUE_ROW, and
+     * above it the stacked value row is at least MAX_VALUE_ROW too.
+     */
+    const stackedValueRowInPx = contentHeightInPx -
+        (data.hasTitle ? titleRowHeightInPx : 0) -
+        (hasStatus ? statusRowHeightInPx : 0);
+    const stackMode = data.hasTitle &&
+        hasStatus &&
+        contentWidthInPx >= COMPACT_HEADER_MIN_CONTENT_WIDTH_IN_PX &&
+        stackedValueRowInPx < MAX_VALUE_ROW_HEIGHT_IN_PX
+        ? ValueWidgetStackMode.Compact
+        : ValueWidgetStackMode.Column;
+    let showTitle = false;
+    let showStatusRow = false;
+    let showSparkline = false;
+    if (stackMode === ValueWidgetStackMode.Compact) {
+        const headerCandidateInPx = Math.max(titleRowHeightInPx, statusRowHeightInPx);
+        if (contentHeightInPx - headerCandidateInPx >= TITLE_GATE_VALUE_ROW_IN_PX) {
+            showTitle = true;
+            showStatusRow = true;
+        }
+    }
+    else {
+        /*
+         * Hand the height out in priority order, never spending a pixel we do not
+         * have and never letting an optional row take the number below a size
+         * worth reading.
+         */
+        let spentInPx = 0;
+        if (data.hasTitle &&
+            contentHeightInPx - spentInPx - titleRowHeightInPx >=
+                TITLE_GATE_VALUE_ROW_IN_PX) {
+            showTitle = true;
+            spentInPx = spentInPx + titleRowHeightInPx;
+        }
+        if (hasStatus &&
+            contentHeightInPx - spentInPx - statusRowHeightInPx >=
+                STATUS_GATE_VALUE_ROW_IN_PX) {
+            showStatusRow = true;
+            spentInPx = spentInPx + statusRowHeightInPx;
+        }
+        /*
+         * The sparkline is admitted only once the value font is ALREADY at its
+         * ceiling, so switching it on cannot make the number smaller. This
+         * replaces a `dashboardComponentHeightInPx > 100` test, which compared the
+         * OUTER tile height and then added a row to a box 26-42px smaller than the
+         * number it had tested — a 40px change in browser width took the value box
+         * from 34.9px to 9.2px, i.e. from a readable number to a dark sliver.
+         */
+        if (data.hasSparklineData &&
+            contentHeightInPx - spentInPx - sparklineRowHeightInPx >=
+                MAX_VALUE_ROW_HEIGHT_IN_PX) {
+            showSparkline = true;
+        }
+    }
+    /*
+     * Give the status slot back when neither occupant can appear: no trend, and
+     * no sparkline left to hover. Recomputing the reservation from the final
+     * flags (rather than decrementing as we go) keeps one source of truth, and
+     * because this only ever SHRINKS the reservation it cannot invalidate the
+     * sparkline decision, which was taken with the row still reserved. Moving
+     * this above the sparkline gate would reintroduce that oscillation.
+     */
+    if (showStatusRow && !data.hasTrend && !showSparkline) {
+        showStatusRow = false;
+    }
+    const headerRowHeightInPx = stackMode === ValueWidgetStackMode.Compact
+        ? Math.max(showTitle ? titleRowHeightInPx : 0, showStatusRow ? statusRowHeightInPx : 0)
+        : 0;
+    const reservedInPx = stackMode === ValueWidgetStackMode.Compact
+        ? headerRowHeightInPx
+        : (showTitle ? titleRowHeightInPx : 0) +
+            (showStatusRow ? statusRowHeightInPx : 0) +
+            (showSparkline ? sparklineRowHeightInPx : 0);
+    const valueRowHeightInPx = Math.max(contentHeightInPx - reservedInPx, 0);
+    const heightLimitedFontInPx = valueRowHeightInPx / VALUE_LINE_HEIGHT_RATIO;
+    const widthBudgetInPx = Math.max(contentWidthInPx - VALUE_HORIZONTAL_PADDING_IN_PX, 0);
+    /*
+     * Try the number with its unit, and drop the unit only when carrying it
+     * would force the digits below the legibility floor on WIDTH. Gating on
+     * width alone matters: when height is the binding constraint, dropping the
+     * unit recovers nothing, so there is no reason to lose the information. The
+     * renderer keeps the full string on the element's `title` either way.
+     */
+    const fontWithUnitInPx = getWidthLimitedFontSizeInPx({
+        widthBudgetInPx: widthBudgetInPx,
+        valueText: data.valueText,
+        unitText: data.unitText,
+    });
+    const showUnit = data.unitText.length > 0 && fontWithUnitInPx >= MIN_VALUE_FONT_SIZE_IN_PX;
+    const widthLimitedFontInPx = showUnit
+        ? fontWithUnitInPx
+        : getWidthLimitedFontSizeInPx({
+            widthBudgetInPx: widthBudgetInPx,
+            valueText: data.valueText,
+            unitText: "",
+        });
+    const valueFontSizeInPx = clamp(Math.min(heightLimitedFontInPx, widthLimitedFontInPx), MIN_VALUE_FONT_SIZE_IN_PX, MAX_VALUE_FONT_SIZE_IN_PX);
+    return {
+        stackMode: stackMode,
+        contentWidthInPx: contentWidthInPx,
+        contentHeightInPx: contentHeightInPx,
+        showTitle: showTitle,
+        showStatusRow: showStatusRow,
+        showSparkline: showSparkline,
+        showUnit: showUnit,
+        titleFontSizeInPx: titleFontSizeInPx,
+        statusFontSizeInPx: statusFontSizeInPx,
+        valueFontSizeInPx: valueFontSizeInPx,
+        unitFontSizeInPx: valueFontSizeInPx * VALUE_UNIT_FONT_SCALE,
+        headerRowHeightInPx: headerRowHeightInPx,
+        titleRowHeightInPx: titleRowHeightInPx,
+        statusRowHeightInPx: statusRowHeightInPx,
+        sparklineRowHeightInPx: sparklineRowHeightInPx,
+        valueRowHeightInPx: valueRowHeightInPx,
+        sparklineWidthInPx: Math.min(Math.max(contentWidthInPx * SPARKLINE_WIDTH_FRACTION, MIN_SPARKLINE_WIDTH_IN_PX), contentWidthInPx, MAX_SPARKLINE_WIDTH_IN_PX),
+        sparklineHeightInPx: sparklineHeightInPx,
+    };
+};
+//# sourceMappingURL=ValueWidgetLayout.js.map

package/build/dist/Utils/Dashboard/ValueWidgetLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValueWidgetLayout.js","sourceRoot":"","sources":["../../../../Utils/Dashboard/ValueWidgetLayout.ts"],"names":[],"mappings":"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"}

package/build/dist/Utils/Metrics/MetricSeriesScope.js

@@ -0,0 +1,203 @@
+import IsNull from "../../Types/BaseDatabase/IsNull";
+/**
+ * A metric monitor grouped by, say, `host.name` evaluates one series per
+ * host and opens ONE incident per breaching host — the affected series is
+ * recorded on the incident as `seriesLabels` (e.g. `{host.name: prod-01}`).
+ * The monitor's stored query configs, however, are shared by every series
+ * it produced: replaying them verbatim on the incident page charts EVERY
+ * host, so an incident about one host renders a wall of unrelated lines
+ * and (worse) the breaching host can be dropped entirely by the Top-N cap.
+ *
+ * This narrows those query configs back down to the one series the
+ * incident/alert is actually about, by pushing the series labels into the
+ * query's attribute filter. Grouping is deliberately left in place: with
+ * the filter applied it yields exactly one series, and the legend still
+ * names it ("host.name=prod-01") instead of collapsing to a bare metric
+ * name.
+ *
+ * Everything here is pure and identity-preserving — when there is nothing
+ * to narrow, the very same objects come back out, so React hosts can call
+ * it without churning state.
+ */
+class MetricSeriesScope {
+    static hasSeriesLabels(seriesLabels) {
+        return Boolean(seriesLabels && Object.keys(seriesLabels).length > 0);
+    }
+    /**
+     * Turn one series-label value into something the metric attribute
+     * filter can express. Returns null when the value cannot be filtered
+     * on at all — the caller then leaves that key alone rather than
+     * emitting a predicate that would silently match nothing.
+     */
+    static toFilterValue(value) {
+        if (value === undefined || value === null) {
+            return new IsNull();
+        }
+        if (typeof value === "string") {
+            /*
+             * "" is what the series builder writes when the attribute is
+             * missing on the sample, so the series really is "rows with no
+             * value for this key" — that is the IsEmpty operator, not an
+             * equality against the empty string (which the UI's filter
+             * sanitizer would drop on the floor anyway).
+             */
+            if (value === "") {
+                return new IsNull();
+            }
+            /*
+             * Whitespace-only is neither: an equality filter on it is dropped
+             * by the sanitizer, and treating it as "unset" would be a lie. Skip
+             * the key instead.
+             */
+            if (value.trim() === "") {
+                return null;
+            }
+            return value;
+        }
+        if (typeof value === "number") {
+            return Number.isFinite(value) ? String(value) : null;
+        }
+        if (typeof value === "boolean") {
+            return String(value);
+        }
+        /*
+         * Arrays, nested objects and Dates have no faithful representation as
+         * a metric attribute equality filter (attributes are a
+         * Map(String, String) in the analytics store), so they are skipped.
+         */
+        return null;
+    }
+    /**
+     * The attribute filters that scope ONE query config to the given
+     * series.
+     *
+     * Only the keys this query actually groups by are considered. The
+     * monitor worker groups every query by the UNION of the group-by keys
+     * across all query configs (so per-series formulas line up), which
+     * means `seriesLabels` routinely carries keys a given query never asked
+     * for — filtering a query on a dimension it does not group by would
+     * narrow the chart to something the monitor never evaluated.
+     */
+    static getSeriesFilterAttributesForQuery(input) {
+        var _a;
+        const filters = {};
+        const seriesLabels = input.seriesLabels;
+        if (!input.queryConfig ||
+            !MetricSeriesScope.hasSeriesLabels(seriesLabels)) {
+            return filters;
+        }
+        const groupByAttributeKeys = ((_a = input.queryConfig.metricQueryData) === null || _a === void 0 ? void 0 : _a.groupByAttributeKeys) || [];
+        for (const key of groupByAttributeKeys) {
+            if (!key) {
+                continue;
+            }
+            // Key not on the incident's series — we know nothing, so filter nothing.
+            if (!Object.prototype.hasOwnProperty.call(seriesLabels, key)) {
+                continue;
+            }
+            const filterValue = MetricSeriesScope.toFilterValue(seriesLabels[key]);
+            if (filterValue === null) {
+                continue;
+            }
+            filters[key] = filterValue;
+        }
+        return filters;
+    }
+    /**
+     * Narrow every query config to the incident's/alert's own series.
+     * Returns the input array unchanged (same reference) when there is
+     * nothing to narrow.
+     */
+    static scopeQueryConfigsToSeries(input) {
+        const queryConfigs = input.queryConfigs || [];
+        if (!MetricSeriesScope.hasSeriesLabels(input.seriesLabels)) {
+            return queryConfigs;
+        }
+        let didNarrowAny = false;
+        const scopedQueryConfigs = queryConfigs.map((queryConfig) => {
+            var _a;
+            const filters = MetricSeriesScope.getSeriesFilterAttributesForQuery({
+                queryConfig: queryConfig,
+                seriesLabels: input.seriesLabels,
+            });
+            if (Object.keys(filters).length === 0) {
+                return queryConfig;
+            }
+            didNarrowAny = true;
+            const metricQueryData = queryConfig.metricQueryData;
+            const existingAttributes = ((_a = metricQueryData === null || metricQueryData === void 0 ? void 0 : metricQueryData.filterData) === null || _a === void 0 ? void 0 : _a["attributes"]) || {};
+            return Object.assign(Object.assign({}, queryConfig), { metricQueryData: Object.assign(Object.assign({}, metricQueryData), { filterData: Object.assign(Object.assign({}, ((metricQueryData === null || metricQueryData === void 0 ? void 0 : metricQueryData.filterData) || {})), { 
+                        /*
+                         * Series labels win over any filter the monitor already
+                         * carried for the same key — they are strictly narrower,
+                         * and they describe the series this incident is about.
+                         */
+                        attributes: Object.assign(Object.assign({}, existingAttributes), filters) }) }) });
+        });
+        return didNarrowAny ? scopedQueryConfigs : queryConfigs;
+    }
+    /**
+     * Convenience wrapper for the places that hold a whole MetricViewData
+     * (the incident/alert "Metrics" cards read one straight off the stored
+     * telemetryQuery). Identity-preserving like the array form.
+     */
+    static scopeMetricViewDataToSeries(input) {
+        const metricViewData = input.metricViewData;
+        if (!metricViewData || !metricViewData.queryConfigs) {
+            /*
+             * `queryConfigs` is non-optional on the type, but this data comes
+             * from stored JSON. Returning early keeps the identity contract and
+             * avoids quietly rewriting a missing list into an empty one.
+             */
+            return metricViewData;
+        }
+        const scopedQueryConfigs = MetricSeriesScope.scopeQueryConfigsToSeries({
+            queryConfigs: metricViewData.queryConfigs,
+            seriesLabels: input.seriesLabels,
+        });
+        if (scopedQueryConfigs === metricViewData.queryConfigs) {
+            return metricViewData;
+        }
+        return Object.assign(Object.assign({}, metricViewData), { queryConfigs: scopedQueryConfigs });
+    }
+    /**
+     * "host.name = prod-01, service.name = api" — a one-line description of
+     * the narrowing that was ACTUALLY applied to these query configs, for
+     * card subtitles.
+     *
+     * Deliberately derived from the filters rather than from the raw labels:
+     * a label the queries never grouped by, or one whose value has no
+     * faithful filter form (an array, a whitespace-only string), does not
+     * narrow anything. Summarising it anyway would have the card claim
+     * "scoped to the affected series" over a chart that still shows every
+     * series — a worse failure than the bug this class fixes.
+     *
+     * Returns "" when nothing was narrowed, which is exactly the condition
+     * for the card to say nothing.
+     */
+    static getAppliedSeriesLabelSummary(input) {
+        const parts = [];
+        const seen = new Set();
+        for (const queryConfig of input.queryConfigs || []) {
+            const filters = MetricSeriesScope.getSeriesFilterAttributesForQuery({
+                queryConfig: queryConfig,
+                seriesLabels: input.seriesLabels,
+            });
+            for (const key of Object.keys(filters)) {
+                if (seen.has(key)) {
+                    continue;
+                }
+                seen.add(key);
+                const filterValue = filters[key];
+                parts.push(`${key} = ${typeof filterValue === "string"
+                    ? filterValue
+                    : MetricSeriesScope.UnsetLabelDisplayValue}`);
+            }
+        }
+        return parts.join(", ");
+    }
+}
+// How an empty (unset) label value is rendered in human-facing summaries.
+MetricSeriesScope.UnsetLabelDisplayValue = "(unset)";
+export default MetricSeriesScope;
+//# sourceMappingURL=MetricSeriesScope.js.map

package/build/dist/Utils/Metrics/MetricSeriesScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetricSeriesScope.js","sourceRoot":"","sources":["../../../../Utils/Metrics/MetricSeriesScope.ts"],"names":[],"mappings":"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"}