@meshmakers/octo-meshboard 3.5.580 → 3.5.590

package/README.md

@@ -587,6 +587,55 @@ interface BarChartWidgetConfig {
 }
 ```
 
+### Line Chart Widget
+Displays time series as line or area charts; every value of `seriesGroupField` becomes one line.
+Series from further queries, formula series and per-series options are described in the library's
+`CLAUDE.md` (section *Line-chart resolution-aware fan-out* and the sections starting with *Line chart:* and
+*Line and bar chart:*).
+
+```typescript
+interface LineChartWidgetConfig {
+  type: 'lineChart';
+  chartType: 'line' | 'area';
+  categoryField: string;          // date/time field of the X axis
+  seriesGroupField: string;       // one line per value
+  valueField: string;
+  unitField?: string;
+  excludedSeriesGroupValues?: string[];  // series group values left out (see below)
+  // ... legend, markers, filters, additionalSeries, primarySeries, stacked, bucketMinutes
+}
+```
+
+**Leaving series out (`excludedSeriesGroupValues`).** A grouped chart can leave out chosen series of its
+primary query, for example a register that duplicates another one. On the fan-out paths (resolution-aware charts, one line per source entity or per group) the values are not queried; in plain grouping the rows the query returns for them are dropped before the series are formed. Either way they are not drawn
+and not in the legend, on the raw archive as on rollups (no query column is needed, so it works where a
+row filter on the group column fails). Board JSON of a widget config:
+
+```json
+{
+  "chartType": "line",
+  "categoryField": "window_start",
+  "seriesGroupField": "obisCode",
+  "valueField": "amount.value",
+  "resolutionAware": true,
+  "requiredAggregation": "SUM",
+  "aggregateSeriesByGroup": true,
+  "excludedSeriesGroupValues": ["1-1:2.9.0 G.03R"]
+}
+```
+
+- Matching is exact on the stored `seriesGroupField` value: case and blanks as stored, before any display
+  label. A value that does not occur changes nothing.
+- A resolution-aware chart without an entity scope and without `aggregateSeriesByGroup` draws one merged
+  line. When an excluded value occurs among the source entities, that line covers only the source entities
+  of the other values (at most 5000 entities are read; entities without a value of the group field drop out).
+- When every value is excluded, or the exclusion leaves no value, the chart shows its normal no-data state.
+- The entity-selector scope still applies to the remaining series. Additional series are not affected
+  (hide them with `visible: false`).
+- The key is written only when the list is not empty; charts without it load and save unchanged.
+- In the dialog: *Field Mapping → Excluded series*, shown once a series group field is set. Choosing another
+  series group field or another query clears the list.
+
 ### Stats Grid Widget
 Displays multiple KPIs in a grid layout.
 

package/fesm2022/meshmakers-octo-meshboard.mjs

@@ -4530,8 +4530,10 @@ class QueryExecutorService {
      * Group-aggregation source resolution (AB#4714): fetches the source entities of `ckTypeId` in a
      * single bulk read and buckets their rtIds by the value of `groupField` (canonical match — case
      * and non-alphanumerics are ignored, so an archive column name maps to its CK attribute). Returns
-     * `groupValue → rtIds`. Optionally restricted to `restrictRtIds` (an entity-selector scope) —
-     * entities outside that set are dropped. Entities whose group attribute is missing/null are
+     * `groupValue → rtIds`. Optionally restricted to `restrictRtIds` (an entity-selector scope): the
+     * restriction is applied server-side as an `rtId IN` field filter of the same request (so the
+     * {@link ENTITY_GROUP_FETCH_CAP} counts scoped entities only), and entities outside the set are
+     * dropped again on the client as a guard. Entities whose group attribute is missing/null are
      * omitted (they cannot be attributed to a line). The population is bounded to
      * {@link ENTITY_GROUP_FETCH_CAP}; a truncated read is logged (never silently capped).
      */
@@ -4541,7 +4543,12 @@ class QueryExecutorService {
         const wanted = canon(groupField);
         const restrict = restrictRtIds && restrictRtIds.length > 0 ? new Set(restrictRtIds) : null;
         const attributeNames = await this.matchingAttributeNames(ckTypeId, wanted, canon);
-        const res = await firstValueFrom(this.entitiesGql.fetch({ variables: { ckTypeId, attributeNames, first: QueryExecutorService.ENTITY_GROUP_FETCH_CAP } }));
+        const res = await firstValueFrom(this.entitiesGql.fetch({ variables: {
+                ckTypeId,
+                attributeNames,
+                first: QueryExecutorService.ENTITY_GROUP_FETCH_CAP,
+                fieldFilters: QueryExecutorService.withRtIdScope(undefined, restrictRtIds)
+            } }));
         const connection = res.data?.runtime?.runtimeEntities;
         const items = connection?.items ?? [];
         const total = connection?.totalCount ?? items.length;
@@ -16795,6 +16802,32 @@ function rowValue(row, valueField, downsampled) {
     }
     return toNumberOrNull(findCellForField(row.cells, valueField)?.value);
 }
+/** Raw `seriesGroupField` value of a row: its cell, else the stream-data row property (`rtId`, AB#8069). */
+function rowSeriesGroupValue(row, seriesGroupField) {
+    return findCellForField(row.cells, seriesGroupField)?.value ?? streamDataRowFieldValue(row, seriesGroupField);
+}
+/**
+ * The rows whose raw `seriesGroupField` value is not excluded (AB#8128), matched exactly on the stored
+ * value. Returns the rows unchanged when nothing is excluded.
+ */
+function withoutExcludedSeriesGroups(rows, seriesGroupField, excluded) {
+    if (excluded.size === 0)
+        return rows;
+    return rows.filter(row => {
+        const group = rowSeriesGroupValue(row, seriesGroupField);
+        return group === null || group === undefined || !excluded.has(String(group));
+    });
+}
+/** The distinct non-empty raw `seriesGroupField` values of the rows, sorted (AB#8128: values offered for exclusion). */
+function distinctSeriesGroupValues(rows, seriesGroupField) {
+    const values = new Set();
+    for (const row of rows) {
+        const group = rowSeriesGroupValue(row, seriesGroupField);
+        if (group !== null && group !== undefined && String(group) !== '')
+            values.add(String(group));
+    }
+    return [...values].sort();
+}
 /**
  * Rows of the primary source → one series per `seriesGroupField` value, exactly the grouping of
  * the single-query chart (a later row of the same series and bucket wins).
@@ -16806,7 +16839,7 @@ function primaryRowsToSeries(rows, fields, downsampled) {
         if (instant === null)
             continue;
         // Stream-data rows carry the source entity as row property (`rtId`), not as cell (AB#8069).
-        const group = findCellForField(row.cells, fields.seriesGroupField)?.value ?? streamDataRowFieldValue(row, fields.seriesGroupField);
+        const group = rowSeriesGroupValue(row, fields.seriesGroupField);
         if (group === null || group === undefined || String(group) === '')
             continue;
         const name = String(group);
@@ -17188,6 +17221,11 @@ function uniqueLabels(labels) {
 
 /** Name of the second value axis of a bar chart with a line on it (AB#8046). */
 const SECONDARY_AXIS = 'secondary';
+/**
+ * Name of the main value axis (AB#8234). Every series names its axis explicitly: binding '' to an
+ * unnamed main axis detaches the series from it (axis stays 0-1.2, bars drawn outside the plot).
+ */
+const PRIMARY_AXIS = 'primary';
 const CHART_TYPE_MAPPING = {
     column: { type: 'column', stack: false },
     bar: { type: 'bar', stack: false },
@@ -17232,6 +17270,8 @@ class BarChartWidgetComponent {
     isMultiSource = this._multiSource.asReadonly();
     data = computed(() => this._seriesData(), /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "data" }] : /* istanbul ignore next */ []));
+    /** Name of the main value axis (template binding, AB#8234). */
+    get primaryAxisName() { return PRIMARY_AXIS; }
     /** Name of the second value axis (template binding, AB#8046). */
     get secondaryAxisName() { return SECONDARY_AXIS; }
     /** A drawn line series uses the second value axis (AB#8046). */
@@ -17772,6 +17812,7 @@ class BarChartWidgetComponent {
 
           <kendo-chart-value-axis>
             <kendo-chart-value-axis-item
+              [name]="primaryAxisName"
               [line]="{ visible: false }"
               [labels]="{ color: chartTheme().muted }"
               [majorGridLines]="{ color: chartTheme().grid }">
@@ -17798,7 +17839,7 @@ class BarChartWidgetComponent {
                 [colorField]="hasColorThresholds() && !series.asLine ? '_color' : ''"
                 [border]="{ width: 0 }"
                 [gap]="0.8"
-                [axis]="series.secondaryAxis ? secondaryAxisName : ''"
+                [axis]="series.secondaryAxis ? secondaryAxisName : primaryAxisName"
                 [dashType]="series.dashType ?? 'solid'"
                 [missingValues]="'gap'"
                 [markers]="{ visible: !!series.asLine }"
@@ -17893,6 +17934,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImpor
 
           <kendo-chart-value-axis>
             <kendo-chart-value-axis-item
+              [name]="primaryAxisName"
               [line]="{ visible: false }"
               [labels]="{ color: chartTheme().muted }"
               [majorGridLines]="{ color: chartTheme().grid }">
@@ -17919,7 +17961,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImpor
                 [colorField]="hasColorThresholds() && !series.asLine ? '_color' : ''"
                 [border]="{ width: 0 }"
                 [gap]="0.8"
-                [axis]="series.secondaryAxis ? secondaryAxisName : ''"
+                [axis]="series.secondaryAxis ? secondaryAxisName : primaryAxisName"
                 [dashType]="series.dashType ?? 'solid'"
                 [missingValues]="'gap'"
                 [markers]="{ visible: !!series.asLine }"
@@ -20323,7 +20365,7 @@ class LineChartWidgetComponent {
                 console.error('Error loading Line Chart data:', err);
                 throw err;
             })));
-            const filteredRows = result.rows.filter(row => LineChartWidgetComponent.SUPPORTED_ROW_TYPES.has(row.__typename ?? ''));
+            const filteredRows = withoutExcludedSeriesGroups(result.rows.filter(row => LineChartWidgetComponent.SUPPORTED_ROW_TYPES.has(row.__typename ?? '')), this.config.seriesGroupField, this.excludedSeriesGroups());
             const downsampled = streamDataArgs?.queryMode === QueryModeDto.DownsamplingDto;
             this.processData(filteredRows, downsampled);
             this._dataInfo.set({ rows: filteredRows.length, points: this._categories().length, total: result.totalCount });
@@ -20408,30 +20450,57 @@ class LineChartWidgetComponent {
      * Group-aggregation fan-out (AB#4714): buckets the source entities by `seriesGroupField` and runs
      * one downsampling call per group with the group's rtIds. The transient downsampling reduces over
      * the group's members server-side, yielding one aggregate line per distinct group value. Falls
-     * back to a single merged series when no group can be resolved.
+     * back to a single merged series when no group can be resolved. Excluded series group values
+     * (AB#8128) are not queried; when they remove every group, nothing is queried and there is no data.
      */
     async loadGroupAggregatedRows(ckTypeId, sourceRtIds, downsample) {
-        const groups = await this.queryExecutor.fetchEntityGroups(ckTypeId, this.config.seriesGroupField, sourceRtIds);
-        if (groups.size === 0) {
+        const allGroups = await this.queryExecutor.fetchEntityGroups(ckTypeId, this.config.seriesGroupField, sourceRtIds);
+        if (allGroups.size === 0) {
             // No group attribute resolved → a single merged line over the whole (optionally scoped) set.
             return downsample(sourceRtIds, this.config.seriesGroupField);
         }
-        const perGroup = await Promise.all(Array.from(groups.entries()).map(([groupValue, rtIds]) => downsample(rtIds, groupValue)));
+        const excluded = this.excludedSeriesGroups();
+        const groups = Array.from(allGroups.entries()).filter(([groupValue]) => !excluded.has(groupValue));
+        if (groups.length === 0)
+            return [];
+        const perGroup = await Promise.all(groups.map(([groupValue, rtIds]) => downsample(rtIds, groupValue)));
         return perGroup.flat();
     }
     /**
      * Default resolution-aware fan-out (AB#4290): one downsampling call per source rtId so each
      * register stays its own line, labeled from its `seriesGroupField` attribute. With no source
-     * scope a single merged series is produced (labeled by the series-group field name).
+     * scope a single merged series is produced (labeled by the series-group field name); when an
+     * excluded series group value (AB#8128) occurs among the source entities, that series covers only
+     * the source entities of the other values. Scoped sources whose label is excluded are not queried.
+     * On that unscoped path the merged series is built from the `fetchEntityGroups` read, so entities
+     * without a group value and entities beyond its 5000 cap are not in it (a full read measured 16-80 s
+     * per load, and the downsampling query fails above ~10 000 rtIds).
      */
     async loadPerRtIdRows(ckTypeId, sourceRtIds, downsample) {
-        const seriesRtIds = sourceRtIds && sourceRtIds.length > 0 ? sourceRtIds : [undefined];
+        const excluded = this.excludedSeriesGroups();
+        if (!sourceRtIds || sourceRtIds.length === 0) {
+            if (excluded.size === 0 || !ckTypeId)
+                return downsample(undefined, this.config.seriesGroupField);
+            const groups = await this.queryExecutor.fetchEntityGroups(ckTypeId, this.config.seriesGroupField);
+            if (!Array.from(groups.keys()).some(groupValue => excluded.has(groupValue))) {
+                return downsample(undefined, this.config.seriesGroupField);
+            }
+            const remaining = Array.from(groups.entries()).filter(([groupValue]) => !excluded.has(groupValue)).flatMap(([, rtIds]) => rtIds);
+            return remaining.length > 0 ? downsample(remaining, this.config.seriesGroupField) : [];
+        }
         const labels = ckTypeId
-            ? await this.queryExecutor.fetchSeriesLabels(ckTypeId, sourceRtIds ?? [], this.config.seriesGroupField)
+            ? await this.queryExecutor.fetchSeriesLabels(ckTypeId, sourceRtIds, this.config.seriesGroupField)
             : new Map();
-        const perSeries = await Promise.all(seriesRtIds.map(rtId => downsample(rtId ? [rtId] : undefined, rtId ? (labels.get(rtId) ?? rtId) : this.config.seriesGroupField)));
+        const perSeries = await Promise.all(sourceRtIds
+            .map(rtId => [rtId, labels.get(rtId) ?? rtId])
+            .filter(([, label]) => !excluded.has(label))
+            .map(([rtId, label]) => downsample([rtId], label)));
         return perSeries.flat();
     }
+    /** Raw series group values the chart leaves out (AB#8128). */
+    excludedSeriesGroups() {
+        return new Set(this.config.excludedSeriesGroupValues ?? []);
+    }
     /**
      * Reshapes one downsampling bin onto the widget's configured value + series-group fields so the
      * shared {@link processData} path plots it. The transient row carries the reduced value under a
@@ -20703,7 +20772,10 @@ class LineChartWidgetComponent {
             scopeRtIds: scope.kind === 'scoped' ? scope.rtIds : undefined
         }));
         const rows = result.rows.filter(row => LineChartWidgetComponent.SUPPORTED_ROW_TYPES.has(row.__typename ?? ''));
-        return { rows, downsampled };
+        return {
+            rows: source.primary ? withoutExcludedSeriesGroups(rows, this.config.seriesGroupField, this.excludedSeriesGroups()) : rows,
+            downsampled
+        };
     }
     /** Writes aligned series into the chart signals (multi-source path, AB#7951). */
     applyAlignedGrid(instants, series) {
@@ -21320,6 +21392,7 @@ class LineChartConfigDialogComponent {
     initialStacked;
     initialPrimarySeries;
     initialBucketMinutes;
+    initialExcludedSeriesGroupValues;
     /** Options of the bucket size dropdown (AB#8046): automatic (`null`) plus the fixed sizes. */
     get bucketSizeOptions() {
         return [
@@ -21331,6 +21404,21 @@ class LineChartConfigDialogComponent {
     additionalSeries = [];
     /** Display options of the primary query's series (AB#7952). */
     primarySeries;
+    /** Raw series group values left out of the chart (AB#8128). */
+    excludedSeriesGroupValues = [];
+    /** Values of the series group field offered for exclusion (AB#8128). */
+    seriesGroupValues = [];
+    isLoadingSeriesGroupValues = false;
+    /** The offered values could not be loaded; typed values still work. */
+    seriesGroupValuesFailed = false;
+    seriesGroupValuesLoadToken = 0;
+    /** Text typed into the Excluded series field; narrows the offered values. */
+    seriesGroupValueFilter = '';
+    /** The offered values that contain the typed text (case-insensitive). */
+    get filteredSeriesGroupValues() {
+        const filter = this.seriesGroupValueFilter.trim().toLowerCase();
+        return filter ? this.seriesGroupValues.filter(v => v.toLowerCase().includes(filter)) : this.seriesGroupValues;
+    }
     // State
     isLoadingInitial = false;
     isLoadingColumns = false;
@@ -21426,6 +21514,7 @@ class LineChartConfigDialogComponent {
         this.form.bucketMinutes = this.initialBucketMinutes && LINE_CHART_BUCKET_MINUTES.includes(this.initialBucketMinutes) ? this.initialBucketMinutes : null;
         this.additionalSeries = this.initialAdditionalSeries ? [...this.initialAdditionalSeries] : [];
         this.primarySeries = this.initialPrimarySeries ? { ...this.initialPrimarySeries } : undefined;
+        this.excludedSeriesGroupValues = this.initialExcludedSeriesGroupValues ? [...this.initialExcludedSeriesGroupValues] : [];
         // Initialize filters
         if (this.initialFilters && this.initialFilters.length > 0) {
             this.filters = this.initialFilters.map((f, index) => ({
@@ -21444,6 +21533,7 @@ class LineChartConfigDialogComponent {
                     if (query) {
                         this.selectedPersistentQuery = query;
                         await this.loadQueryColumns(query.rtId);
+                        await this.loadSeriesGroupValues();
                     }
                 }
                 this.isLoadingInitial = false;
@@ -21460,6 +21550,11 @@ class LineChartConfigDialogComponent {
         this.form.seriesGroupField = '';
         this.form.valueField = '';
         this.form.unitField = '';
+        this.excludedSeriesGroupValues = [];
+        this.seriesGroupValues = [];
+        this.seriesGroupValuesFailed = false;
+        this.isLoadingSeriesGroupValues = false;
+        this.seriesGroupValuesLoadToken++;
         if (query) {
             await this.loadQueryColumns(query.rtId);
         }
@@ -21518,6 +21613,54 @@ class LineChartConfigDialogComponent {
             aggregationType: c.aggregationType ?? null
         })));
     }
+    /**
+     * Loads the values of the series group field offered for exclusion (AB#8128): for a stream-data query the
+     * group values of the source entities (the `fetchEntityGroups` read the widget groups by), for a runtime
+     * query the distinct values of that column in the query result.
+     */
+    async loadSeriesGroupValues() {
+        const query = this.selectedPersistentQuery;
+        const field = this.form.seriesGroupField;
+        const token = ++this.seriesGroupValuesLoadToken;
+        this.seriesGroupValues = [];
+        this.seriesGroupValuesFailed = false;
+        if (!query || !field) {
+            this.isLoadingSeriesGroupValues = false;
+            return;
+        }
+        this.isLoadingSeriesGroupValues = true;
+        const isCurrent = () => token === this.seriesGroupValuesLoadToken;
+        try {
+            const family = queryFamily(query.ckTypeId) ?? this.initialQueryFamily ?? await this.queryExecutor.resolveFamily(query.rtId);
+            let values;
+            if (family === 'streamData') {
+                const ckTypeId = (await this.queryExecutor.fetchQueryArchive(query.rtId))?.ckTypeId;
+                if (!ckTypeId)
+                    throw new Error('The query archive has no CK type.');
+                values = [...(await this.queryExecutor.fetchEntityGroups(ckTypeId, field)).keys()].sort();
+            }
+            else {
+                const result = await firstValueFrom(this.queryExecutor.execute(family, query.rtId));
+                values = distinctSeriesGroupValues(result.rows, field);
+            }
+            if (isCurrent())
+                this.seriesGroupValues = values;
+        }
+        catch (error) {
+            console.error('Error loading series group values:', error);
+            if (isCurrent())
+                this.seriesGroupValuesFailed = true;
+        }
+        finally {
+            if (isCurrent())
+                this.isLoadingSeriesGroupValues = false;
+        }
+    }
+    /** The author picked another series group field: the values excluded for the old field no longer apply. */
+    async onSeriesGroupFieldChange() {
+        this.excludedSeriesGroupValues = [];
+        await this.loadSeriesGroupValues();
+    }
     onFiltersChange(updatedFilters) {
         this.filters = updatedFilters;
     }
@@ -21556,7 +21699,8 @@ class LineChartConfigDialogComponent {
             additionalSeries: this.effectiveAdditionalSeries.length > 0 ? this.effectiveAdditionalSeries : undefined,
             stacked: this.form.chartType === 'area' && this.form.stacked ? true : undefined,
             primarySeries: this.selectedQueryFamily === 'streamData' ? this.primarySeries : undefined,
-            bucketMinutes: this.selectedQueryFamily === 'streamData' && this.form.bucketMinutes ? this.form.bucketMinutes : undefined
+            bucketMinutes: this.selectedQueryFamily === 'streamData' && this.form.bucketMinutes ? this.form.bucketMinutes : undefined,
+            excludedSeriesGroupValues: this.excludedSeriesGroupValues.length > 0 ? [...this.excludedSeriesGroupValues] : undefined
         };
         this.windowRef.close(result);
     }
@@ -21570,7 +21714,7 @@ class LineChartConfigDialogComponent {
         this.windowRef.close();
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: LineChartConfigDialogComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.1.5", type: LineChartConfigDialogComponent, isStandalone: true, selector: "mm-line-chart-config-dialog", inputs: { initialQueryRtId: "initialQueryRtId", initialQueryName: "initialQueryName", initialQueryFamily: "initialQueryFamily", initialIgnoreTimeFilter: "initialIgnoreTimeFilter", initialEntitySelectorId: "initialEntitySelectorId", initialResolutionAware: "initialResolutionAware", initialRequiredAggregation: "initialRequiredAggregation", initialChartType: "initialChartType", initialCategoryField: "initialCategoryField", initialSeriesGroupField: "initialSeriesGroupField", initialValueField: "initialValueField", initialUnitField: "initialUnitField", initialShowLegend: "initialShowLegend", initialLegendPosition: "initialLegendPosition", initialShowMarkers: "initialShowMarkers", initialShowDataBadge: "initialShowDataBadge", initialReferenceLines: "initialReferenceLines", initialFilters: "initialFilters", initialAdditionalSeries: "initialAdditionalSeries", initialStacked: "initialStacked", initialPrimarySeries: "initialPrimarySeries", initialBucketMinutes: "initialBucketMinutes" }, viewQueries: [{ propertyName: "querySelector", first: true, predicate: ["querySelector"], descendants: true }], ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.1.5", type: LineChartConfigDialogComponent, isStandalone: true, selector: "mm-line-chart-config-dialog", inputs: { initialQueryRtId: "initialQueryRtId", initialQueryName: "initialQueryName", initialQueryFamily: "initialQueryFamily", initialIgnoreTimeFilter: "initialIgnoreTimeFilter", initialEntitySelectorId: "initialEntitySelectorId", initialResolutionAware: "initialResolutionAware", initialRequiredAggregation: "initialRequiredAggregation", initialChartType: "initialChartType", initialCategoryField: "initialCategoryField", initialSeriesGroupField: "initialSeriesGroupField", initialValueField: "initialValueField", initialUnitField: "initialUnitField", initialShowLegend: "initialShowLegend", initialLegendPosition: "initialLegendPosition", initialShowMarkers: "initialShowMarkers", initialShowDataBadge: "initialShowDataBadge", initialReferenceLines: "initialReferenceLines", initialFilters: "initialFilters", initialAdditionalSeries: "initialAdditionalSeries", initialStacked: "initialStacked", initialPrimarySeries: "initialPrimarySeries", initialBucketMinutes: "initialBucketMinutes", initialExcludedSeriesGroupValues: "initialExcludedSeriesGroupValues" }, viewQueries: [{ propertyName: "querySelector", first: true, predicate: ["querySelector"], descendants: true }], ngImport: i0, template: `
     <div class="config-container">
 
       <div class="config-form" [class.loading]="isLoadingInitial">
@@ -21659,6 +21803,7 @@ class LineChartConfigDialogComponent {
                 [valueField]="'attributePath'"
                 [valuePrimitive]="true"
                 [(ngModel)]="form.seriesGroupField"
+                (ngModelChange)="onSeriesGroupFieldChange()"
                 placeholder="Select grouping field...">
                 <ng-template kendoComboBoxItemTemplate let-dataItem>
                   <div class="column-item">
@@ -21670,6 +21815,28 @@ class LineChartConfigDialogComponent {
               <p class="field-hint">Each unique value becomes a separate line (e.g., OBIS code).</p>
             </div>
 
+            @if (form.seriesGroupField) {
+              <div class="form-field">
+                <label for="line-chart-excluded-series">Excluded series</label>
+                <kendo-multiselect
+                  focusableId="line-chart-excluded-series"
+                  data-chart-option="excludedSeriesGroupValues"
+                  [data]="filteredSeriesGroupValues"
+                  [allowCustom]="true"
+                  [filterable]="true"
+                  (filterChange)="seriesGroupValueFilter = $event"
+                  [loading]="isLoadingSeriesGroupValues"
+                  [(ngModel)]="excludedSeriesGroupValues"
+                  placeholder="No series excluded - pick or type a value">
+                </kendo-multiselect>
+                @if (seriesGroupValuesFailed) {
+                  <p class="field-hint" data-hint="series-group-values-failed">Could not load the values of {{ form.seriesGroupField }} - type a value and press Enter.</p>
+                } @else {
+                  <p class="field-hint">Values of {{ form.seriesGroupField }} whose line is left out. Exact match on the stored value.</p>
+                }
+              </div>
+            }
+
             <div class="form-field">
               <label>Value Field (Y-Axis) <span class="required">*</span></label>
               <kendo-combobox
@@ -21858,7 +22025,7 @@ class LineChartConfigDialogComponent {
         </button>
       </div>
     </div>
-  `, isInline: true, styles: [":host{display:block;height:100%}.config-container{display:flex;flex-direction:column;height:100%}.config-form{display:flex;flex-direction:column;gap:20px;flex:1;overflow-y:auto;padding:16px;position:relative}.config-form.loading{pointer-events:none}.config-section{padding:16px;background:var(--kendo-color-surface-alt, #f8f9fa);border:1px solid var(--kendo-color-border, #dee2e6);border-radius:4px}.section-title{margin:0 0 16px;font-size:1rem;font-weight:600;color:var(--kendo-color-primary, #0d6efd)}.section-hint{margin:0 0 12px;font-size:.85rem;color:var(--kendo-color-subtle, #6c757d)}.form-field{display:flex;flex-direction:column;gap:6px;margin-bottom:12px}.form-field:last-child{margin-bottom:0}.form-field label{font-weight:600;font-size:.9rem;color:var(--kendo-color-on-app-surface, #212529)}.required{color:var(--kendo-color-error, #dc3545)}.field-hint{margin:0;font-size:.8rem;color:var(--kendo-color-subtle, #6c757d)}.chart-type-grid{display:grid;grid-template-columns:1fr 1fr;gap:12px}.radio-label{display:flex;align-items:center;gap:8px;cursor:pointer;font-weight:400}.form-row{display:flex;gap:24px;align-items:center}.checkbox-field{flex-direction:row;align-items:center;margin-bottom:0}.checkbox-field label{display:flex;align-items:center;gap:8px;cursor:pointer;font-weight:400}.column-item{display:flex;justify-content:space-between;gap:16px}.column-path{font-weight:500}.column-type{font-size:.8rem;color:var(--kendo-color-subtle, #6c757d)}.form-section{margin-top:8px}.form-section h4{margin:0 0 4px;font-size:.95rem;font-weight:600}.reference-line-row{display:flex;gap:8px;align-items:center;margin-bottom:8px}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "ngmodule", type: FormsModule }, { kind: "directive", type: i1$1.DefaultValueAccessor, selector: "input:not([type=checkbox]):not([ngNoCva])[formControlName],textarea:not([ngNoCva])[formControlName],input:not([type=checkbox]):not([ngNoCva])[formControl],textarea:not([ngNoCva])[formControl],input:not([type=checkbox]):not([ngNoCva])[ngModel],textarea:not([ngNoCva])[ngModel],[ngDefaultControl]" }, { kind: "directive", type: i1$1.CheckboxControlValueAccessor, selector: "input[type=checkbox]:not([ngNoCva])[formControlName],input[type=checkbox]:not([ngNoCva])[formControl],input[type=checkbox]:not([ngNoCva])[ngModel]" }, { kind: "directive", type: i1$1.RadioControlValueAccessor, selector: "input[type=radio]:not([ngNoCva])[formControlName],input[type=radio]:not([ngNoCva])[formControl],input[type=radio]:not([ngNoCva])[ngModel]", inputs: ["name", "formControlName", "value"] }, { kind: "directive", type: i1$1.NgControlStatus, selector: "[formControlName],[ngModel],[formControl]" }, { kind: "directive", type: i1$1.NgModel, selector: "[ngModel]:not([formControlName]):not([formControl])", inputs: ["name", "disabled", "ngModel", "ngModelOptions"], outputs: ["ngModelChange"], exportAs: ["ngModel"] }, { kind: "ngmodule", type: ButtonsModule }, { kind: "component", type: i2.ButtonComponent, selector: "button[kendoButton]", inputs: ["arrowIcon", "toggleable", "togglable", "selected", "tabIndex", "imageUrl", "iconPosition", "iconClass", "icon", "disabled", "size", "rounded", "fillMode", "themeColor", "svgIcon"], outputs: ["selectedChange", "click"], exportAs: ["kendoButton"] }, { kind: "ngmodule", type: InputsModule }, { kind: "component", type: i3.TextBoxComponent, selector: "kendo-textbox", inputs: ["focusableId", "title", "type", "disabled", "readonly", "tabindex", "value", "selectOnFocus", "showSuccessIcon", "showErrorIcon", "clearButton", "successIcon", "successSvgIcon", "errorIcon", "errorSvgIcon", "clearButtonIcon", "clearButtonSvgIcon", "size", "rounded", "fillMode", "tabIndex", "placeholder", "maxlength", "inputAttributes"], outputs: ["valueChange", "inputFocus", "inputBlur", "focus", "blur"], exportAs: ["kendoTextBox"] }, { kind: "component", type: i3.NumericTextBoxComponent, selector: "kendo-numerictextbox", inputs: ["focusableId", "disabled", "readonly", "title", "autoCorrect", "format", "max", "min", "decimals", "placeholder", "step", "spinners", "rangeValidation", "tabindex", "tabIndex", "changeValueOnScroll", "selectOnFocus", "value", "maxlength", "size", "rounded", "fillMode", "inputAttributes"], outputs: ["valueChange", "focus", "blur", "inputFocus", "inputBlur"], exportAs: ["kendoNumericTextBox"] }, { kind: "directive", type: i3.CheckBoxDirective, selector: "input[kendoCheckBox]", inputs: ["size", "rounded"] }, { kind: "directive", type: i3.RadioButtonDirective, selector: "input[kendoRadioButton]", inputs: ["size"] }, { kind: "ngmodule", type: DropDownsModule }, { kind: "directive", type: i4.ItemTemplateDirective, selector: "[kendoDropDownListItemTemplate],[kendoComboBoxItemTemplate],[kendoAutoCompleteItemTemplate],[kendoMultiSelectItemTemplate]" }, { kind: "component", type: i4.ComboBoxComponent, selector: "kendo-combobox", inputs: ["icon", "svgIcon", "inputAttributes", "showStickyHeader", "focusableId", "allowCustom", "data", "value", "textField", "valueField", "valuePrimitive", "valueNormalizer", "placeholder", "adaptiveMode", "adaptiveTitle", "adaptiveSubtitle", "popupSettings", "listHeight", "loading", "suggest", "clearButton", "disabled", "itemDisabled", "readonly", "tabindex", "tabIndex", "filterable", "virtual", "size", "rounded", "fillMode"], outputs: ["valueChange", "selectionChange", "filterChange", "open", "opened", "close", "closed", "focus", "blur", "inputFocus", "inputBlur", "escape"], exportAs: ["kendoComboBox"] }, { kind: "component", type: i4.DropDownListComponent, selector: "kendo-dropdownlist", inputs: ["customIconClass", "showStickyHeader", "icon", "svgIcon", "loading", "data", "value", "textField", "valueField", "adaptiveMode", "adaptiveTitle", "adaptiveSubtitle", "popupSettings", "listHeight", "defaultItem", "disabled", "itemDisabled", "readonly", "filterable", "virtual", "ignoreCase", "delay", "valuePrimitive", "tabindex", "tabIndex", "size", "rounded", "fillMode", "leftRightArrowsNavigation", "id"], outputs: ["valueChange", "filterChange", "selectionChange", "open", "opened", "close", "closed", "focus", "blur"], exportAs: ["kendoDropDownList"] }, { kind: "ngmodule", type: SVGIconModule }, { kind: "component", type: FieldFilterEditorComponent, selector: "mm-field-filter-editor", inputs: ["availableAttributes", "ckTypeId", "hideNavigationProperties", "attributePaths", "enableVariables", "availableVariables", "filters"], outputs: ["filtersChange"] }, { kind: "component", type: QuerySelectorComponent, selector: "mm-query-selector", inputs: ["placeholder", "hint", "disabled", "acceptFamilies"], outputs: ["querySelected", "queriesLoaded"] }, { kind: "component", type: SdTimeFilterToggleComponent, selector: "mm-sd-time-filter-toggle", inputs: ["family", "ignoreTimeFilter"], outputs: ["ignoreTimeFilterChange"] }, { kind: "component", type: EntitySelectorScopePickerComponent, selector: "mm-entity-selector-scope-picker", inputs: ["family", "entitySelectorId", "selectors"], outputs: ["entitySelectorIdChange"] }, { kind: "component", type: LoadingOverlayComponent, selector: "mm-loading-overlay", inputs: ["loading"] }, { kind: "component", type: LineChartSeriesEditorComponent, selector: "mm-line-chart-series-editor", inputs: ["series", "primary", "stackedChart", "selectors", "alignment", "areaChart", "linesAllowed", "defaultCategoryField"], outputs: ["primaryChange", "seriesChange"] }], changeDetection: i0.ChangeDetectionStrategy.Eager });
+  `, isInline: true, styles: [":host{display:block;height:100%}.config-container{display:flex;flex-direction:column;height:100%}.config-form{display:flex;flex-direction:column;gap:20px;flex:1;overflow-y:auto;padding:16px;position:relative}.config-form.loading{pointer-events:none}.config-section{padding:16px;background:var(--kendo-color-surface-alt, #f8f9fa);border:1px solid var(--kendo-color-border, #dee2e6);border-radius:4px}.section-title{margin:0 0 16px;font-size:1rem;font-weight:600;color:var(--kendo-color-primary, #0d6efd)}.section-hint{margin:0 0 12px;font-size:.85rem;color:var(--kendo-color-subtle, #6c757d)}.form-field{display:flex;flex-direction:column;gap:6px;margin-bottom:12px}.form-field:last-child{margin-bottom:0}.form-field label{font-weight:600;font-size:.9rem;color:var(--kendo-color-on-app-surface, #212529)}.required{color:var(--kendo-color-error, #dc3545)}.field-hint{margin:0;font-size:.8rem;color:var(--kendo-color-subtle, #6c757d)}.chart-type-grid{display:grid;grid-template-columns:1fr 1fr;gap:12px}.radio-label{display:flex;align-items:center;gap:8px;cursor:pointer;font-weight:400}.form-row{display:flex;gap:24px;align-items:center}.checkbox-field{flex-direction:row;align-items:center;margin-bottom:0}.checkbox-field label{display:flex;align-items:center;gap:8px;cursor:pointer;font-weight:400}.column-item{display:flex;justify-content:space-between;gap:16px}.column-path{font-weight:500}.column-type{font-size:.8rem;color:var(--kendo-color-subtle, #6c757d)}.form-section{margin-top:8px}.form-section h4{margin:0 0 4px;font-size:.95rem;font-weight:600}.reference-line-row{display:flex;gap:8px;align-items:center;margin-bottom:8px}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "ngmodule", type: FormsModule }, { kind: "directive", type: i1$1.DefaultValueAccessor, selector: "input:not([type=checkbox]):not([ngNoCva])[formControlName],textarea:not([ngNoCva])[formControlName],input:not([type=checkbox]):not([ngNoCva])[formControl],textarea:not([ngNoCva])[formControl],input:not([type=checkbox]):not([ngNoCva])[ngModel],textarea:not([ngNoCva])[ngModel],[ngDefaultControl]" }, { kind: "directive", type: i1$1.CheckboxControlValueAccessor, selector: "input[type=checkbox]:not([ngNoCva])[formControlName],input[type=checkbox]:not([ngNoCva])[formControl],input[type=checkbox]:not([ngNoCva])[ngModel]" }, { kind: "directive", type: i1$1.RadioControlValueAccessor, selector: "input[type=radio]:not([ngNoCva])[formControlName],input[type=radio]:not([ngNoCva])[formControl],input[type=radio]:not([ngNoCva])[ngModel]", inputs: ["name", "formControlName", "value"] }, { kind: "directive", type: i1$1.NgControlStatus, selector: "[formControlName],[ngModel],[formControl]" }, { kind: "directive", type: i1$1.NgModel, selector: "[ngModel]:not([formControlName]):not([formControl])", inputs: ["name", "disabled", "ngModel", "ngModelOptions"], outputs: ["ngModelChange"], exportAs: ["ngModel"] }, { kind: "ngmodule", type: ButtonsModule }, { kind: "component", type: i2.ButtonComponent, selector: "button[kendoButton]", inputs: ["arrowIcon", "toggleable", "togglable", "selected", "tabIndex", "imageUrl", "iconPosition", "iconClass", "icon", "disabled", "size", "rounded", "fillMode", "themeColor", "svgIcon"], outputs: ["selectedChange", "click"], exportAs: ["kendoButton"] }, { kind: "ngmodule", type: InputsModule }, { kind: "component", type: i3.TextBoxComponent, selector: "kendo-textbox", inputs: ["focusableId", "title", "type", "disabled", "readonly", "tabindex", "value", "selectOnFocus", "showSuccessIcon", "showErrorIcon", "clearButton", "successIcon", "successSvgIcon", "errorIcon", "errorSvgIcon", "clearButtonIcon", "clearButtonSvgIcon", "size", "rounded", "fillMode", "tabIndex", "placeholder", "maxlength", "inputAttributes"], outputs: ["valueChange", "inputFocus", "inputBlur", "focus", "blur"], exportAs: ["kendoTextBox"] }, { kind: "component", type: i3.NumericTextBoxComponent, selector: "kendo-numerictextbox", inputs: ["focusableId", "disabled", "readonly", "title", "autoCorrect", "format", "max", "min", "decimals", "placeholder", "step", "spinners", "rangeValidation", "tabindex", "tabIndex", "changeValueOnScroll", "selectOnFocus", "value", "maxlength", "size", "rounded", "fillMode", "inputAttributes"], outputs: ["valueChange", "focus", "blur", "inputFocus", "inputBlur"], exportAs: ["kendoNumericTextBox"] }, { kind: "directive", type: i3.CheckBoxDirective, selector: "input[kendoCheckBox]", inputs: ["size", "rounded"] }, { kind: "directive", type: i3.RadioButtonDirective, selector: "input[kendoRadioButton]", inputs: ["size"] }, { kind: "ngmodule", type: DropDownsModule }, { kind: "directive", type: i4.ItemTemplateDirective, selector: "[kendoDropDownListItemTemplate],[kendoComboBoxItemTemplate],[kendoAutoCompleteItemTemplate],[kendoMultiSelectItemTemplate]" }, { kind: "component", type: i4.ComboBoxComponent, selector: "kendo-combobox", inputs: ["icon", "svgIcon", "inputAttributes", "showStickyHeader", "focusableId", "allowCustom", "data", "value", "textField", "valueField", "valuePrimitive", "valueNormalizer", "placeholder", "adaptiveMode", "adaptiveTitle", "adaptiveSubtitle", "popupSettings", "listHeight", "loading", "suggest", "clearButton", "disabled", "itemDisabled", "readonly", "tabindex", "tabIndex", "filterable", "virtual", "size", "rounded", "fillMode"], outputs: ["valueChange", "selectionChange", "filterChange", "open", "opened", "close", "closed", "focus", "blur", "inputFocus", "inputBlur", "escape"], exportAs: ["kendoComboBox"] }, { kind: "component", type: i4.DropDownListComponent, selector: "kendo-dropdownlist", inputs: ["customIconClass", "showStickyHeader", "icon", "svgIcon", "loading", "data", "value", "textField", "valueField", "adaptiveMode", "adaptiveTitle", "adaptiveSubtitle", "popupSettings", "listHeight", "defaultItem", "disabled", "itemDisabled", "readonly", "filterable", "virtual", "ignoreCase", "delay", "valuePrimitive", "tabindex", "tabIndex", "size", "rounded", "fillMode", "leftRightArrowsNavigation", "id"], outputs: ["valueChange", "filterChange", "selectionChange", "open", "opened", "close", "closed", "focus", "blur"], exportAs: ["kendoDropDownList"] }, { kind: "component", type: i4.MultiSelectComponent, selector: "kendo-multiselect", inputs: ["showStickyHeader", "focusableId", "autoClose", "loading", "data", "value", "valueField", "textField", "tabindex", "tabIndex", "size", "rounded", "fillMode", "placeholder", "adaptiveMode", "adaptiveTitle", "adaptiveSubtitle", "disabled", "itemDisabled", "checkboxes", "readonly", "filterable", "virtual", "popupSettings", "listHeight", "valuePrimitive", "clearButton", "tagMapper", "allowCustom", "valueNormalizer", "inputAttributes"], outputs: ["filterChange", "valueChange", "open", "opened", "close", "closed", "focus", "blur", "inputFocus", "inputBlur", "removeTag"], exportAs: ["kendoMultiSelect"] }, { kind: "ngmodule", type: SVGIconModule }, { kind: "component", type: FieldFilterEditorComponent, selector: "mm-field-filter-editor", inputs: ["availableAttributes", "ckTypeId", "hideNavigationProperties", "attributePaths", "enableVariables", "availableVariables", "filters"], outputs: ["filtersChange"] }, { kind: "component", type: QuerySelectorComponent, selector: "mm-query-selector", inputs: ["placeholder", "hint", "disabled", "acceptFamilies"], outputs: ["querySelected", "queriesLoaded"] }, { kind: "component", type: SdTimeFilterToggleComponent, selector: "mm-sd-time-filter-toggle", inputs: ["family", "ignoreTimeFilter"], outputs: ["ignoreTimeFilterChange"] }, { kind: "component", type: EntitySelectorScopePickerComponent, selector: "mm-entity-selector-scope-picker", inputs: ["family", "entitySelectorId", "selectors"], outputs: ["entitySelectorIdChange"] }, { kind: "component", type: LoadingOverlayComponent, selector: "mm-loading-overlay", inputs: ["loading"] }, { kind: "component", type: LineChartSeriesEditorComponent, selector: "mm-line-chart-series-editor", inputs: ["series", "primary", "stackedChart", "selectors", "alignment", "areaChart", "linesAllowed", "defaultCategoryField"], outputs: ["primaryChange", "seriesChange"] }], changeDetection: i0.ChangeDetectionStrategy.Eager });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: LineChartConfigDialogComponent, decorators: [{
             type: Component,
@@ -21964,6 +22131,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImpor
                 [valueField]="'attributePath'"
                 [valuePrimitive]="true"
                 [(ngModel)]="form.seriesGroupField"
+                (ngModelChange)="onSeriesGroupFieldChange()"
                 placeholder="Select grouping field...">
                 <ng-template kendoComboBoxItemTemplate let-dataItem>
                   <div class="column-item">
@@ -21975,6 +22143,28 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImpor
               <p class="field-hint">Each unique value becomes a separate line (e.g., OBIS code).</p>
             </div>
 
+            @if (form.seriesGroupField) {
+              <div class="form-field">
+                <label for="line-chart-excluded-series">Excluded series</label>
+                <kendo-multiselect
+                  focusableId="line-chart-excluded-series"
+                  data-chart-option="excludedSeriesGroupValues"
+                  [data]="filteredSeriesGroupValues"
+                  [allowCustom]="true"
+                  [filterable]="true"
+                  (filterChange)="seriesGroupValueFilter = $event"
+                  [loading]="isLoadingSeriesGroupValues"
+                  [(ngModel)]="excludedSeriesGroupValues"
+                  placeholder="No series excluded - pick or type a value">
+                </kendo-multiselect>
+                @if (seriesGroupValuesFailed) {
+                  <p class="field-hint" data-hint="series-group-values-failed">Could not load the values of {{ form.seriesGroupField }} - type a value and press Enter.</p>
+                } @else {
+                  <p class="field-hint">Values of {{ form.seriesGroupField }} whose line is left out. Exact match on the stored value.</p>
+                }
+              </div>
+            }
+
             <div class="form-field">
               <label>Value Field (Y-Axis) <span class="required">*</span></label>
               <kendo-combobox
@@ -22211,6 +22401,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImpor
                 type: Input
             }], initialBucketMinutes: [{
                 type: Input
+            }], initialExcludedSeriesGroupValues: [{
+                type: Input
             }] } });
 
 /**
@@ -37741,7 +37933,8 @@ function registerDefaultWidgets(registry) {
                 initialAdditionalSeries: lineWidget.additionalSeries,
                 initialStacked: lineWidget.stacked,
                 initialPrimarySeries: lineWidget.primarySeries,
-                initialBucketMinutes: lineWidget.bucketMinutes
+                initialBucketMinutes: lineWidget.bucketMinutes,
+                initialExcludedSeriesGroupValues: lineWidget.excludedSeriesGroupValues
             };
         },
         applyConfigResult: (widget, result) => {
@@ -37781,7 +37974,8 @@ function registerDefaultWidgets(registry) {
                 additionalSeries: result.additionalSeries?.length ? result.additionalSeries : undefined,
                 stacked: result.stacked || undefined,
                 primarySeries: displayOptionsOrUndefined(result.primarySeries),
-                bucketMinutes: bucketMinutesOrUndefined(result.bucketMinutes)
+                bucketMinutes: bucketMinutesOrUndefined(result.bucketMinutes),
+                excludedSeriesGroupValues: excludedSeriesGroupValuesOrUndefined(result.excludedSeriesGroupValues)
             };
         },
         createDefaultConfig: (base) => ({
@@ -37839,7 +38033,10 @@ function registerDefaultWidgets(registry) {
                 // AB#7952: written only when a primary display option is not default.
                 ...(displayOptionsOrUndefined(widget.primarySeries) && { primarySeries: displayOptionsOrUndefined(widget.primarySeries) }),
                 // AB#8046: written only when a fixed bucket size is set.
-                ...(bucketMinutesOrUndefined(widget.bucketMinutes) && { bucketMinutes: bucketMinutesOrUndefined(widget.bucketMinutes) })
+                ...(bucketMinutesOrUndefined(widget.bucketMinutes) && { bucketMinutes: bucketMinutesOrUndefined(widget.bucketMinutes) }),
+                ...(excludedSeriesGroupValuesOrUndefined(widget.excludedSeriesGroupValues) && {
+                    excludedSeriesGroupValues: excludedSeriesGroupValuesOrUndefined(widget.excludedSeriesGroupValues)
+                })
             }
         }),
         fromPersistedConfig: (data, base) => {
@@ -38935,12 +39132,22 @@ function lineChartSeriesFromPersisted(config) {
     const bucketMinutes = bucketMinutesOrUndefined(config['bucketMinutes']);
     if (bucketMinutes)
         out.bucketMinutes = bucketMinutes;
+    const excluded = excludedSeriesGroupValuesOrUndefined(config['excludedSeriesGroupValues']);
+    if (excluded)
+        out.excludedSeriesGroupValues = excluded;
     return out;
 }
 /** A supported fixed bucket size of a line chart (AB#8046), else `undefined` (pixel-driven buckets). */
 function bucketMinutesOrUndefined(value) {
     return typeof value === 'number' && LINE_CHART_BUCKET_MINUTES.includes(value) ? value : undefined;
 }
+/** The excluded series group values of a line chart (AB#8128): the non-empty strings, without duplicates, else `undefined`. */
+function excludedSeriesGroupValuesOrUndefined(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const values = [...new Set(value.filter((v) => typeof v === 'string' && v !== ''))];
+    return values.length > 0 ? values : undefined;
+}
 /**
  * Reads `additionalSeries` / `primarySeries` of a persisted bar chart (AB#7953) with the line chart
  * rules (unknown kinds dropped, display options only as `false`). The bar chart keeps only