@meshmakers/octo-meshboard 3.5.580 → 3.5.600

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshmakers/octo-meshboard",
-  "version": "3.5.580",
+  "version": "3.5.600",
   "peerDependencies": {
     "@angular/common": "^22.0.0",
     "@angular/core": "^22.0.0",

package/types/meshmakers-octo-meshboard.d.ts

@@ -1039,6 +1039,12 @@ interface LineChartWidgetConfig extends WidgetConfig {
      * follows the chart width, as before.
      */
     bucketMinutes?: number;
+    /**
+     * Raw {@link seriesGroupField} values whose series the chart leaves out of the primary data source
+     * (AB#8128): not queried, not drawn, not in the legend. Exact match on the stored value (case and
+     * whitespace as stored), before any display label. Omitted when empty.
+     */
+    excludedSeriesGroupValues?: string[];
 }
 /** Fixed bucket sizes of a line chart in minutes (AB#8046). All divide one hour, so they stay on the wall-clock grid across DST changes. */
 declare const LINE_CHART_BUCKET_MINUTES: readonly number[];
@@ -2474,8 +2480,10 @@ declare 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).
      */
@@ -5695,6 +5703,8 @@ declare class BarChartWidgetComponent implements DashboardWidget<BarChartWidgetC
     private readonly _multiSource;
     readonly isMultiSource: _angular_core.Signal<boolean>;
     readonly data: _angular_core.Signal<SeriesData[]>;
+    /** Name of the main value axis (template binding, AB#8234). */
+    get primaryAxisName(): string;
     /** Name of the second value axis (template binding, AB#8046). */
     get secondaryAxisName(): string;
     /** A drawn line series uses the second value axis (AB#8046). */
@@ -6120,15 +6130,23 @@ declare class LineChartWidgetComponent implements DashboardWidget<LineChartWidge
      * 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.
      */
     private loadGroupAggregatedRows;
     /**
      * 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).
      */
     private loadPerRtIdRows;
+    /** Raw series group values the chart leaves out (AB#8128). */
+    private excludedSeriesGroups;
     /**
      * 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
@@ -6236,6 +6254,8 @@ interface LineChartConfigResult extends WidgetConfigResult {
     stacked?: boolean;
     /** Fixed bucket size in minutes (AB#8046); absent = follows the chart width. */
     bucketMinutes?: number;
+    /** Raw series group values left out of the chart (AB#8128); absent when none. */
+    excludedSeriesGroupValues?: string[];
 }
 /**
  * Configuration dialog for Line Chart widgets.
@@ -6270,6 +6290,7 @@ declare class LineChartConfigDialogComponent implements OnInit {
     initialStacked?: boolean;
     initialPrimarySeries?: LineChartSeriesDisplayOptions;
     initialBucketMinutes?: number;
+    initialExcludedSeriesGroupValues?: string[];
     /** Options of the bucket size dropdown (AB#8046): automatic (`null`) plus the fixed sizes. */
     get bucketSizeOptions(): {
         value: number | null;
@@ -6279,6 +6300,18 @@ declare class LineChartConfigDialogComponent implements OnInit {
     additionalSeries: LineChartSeriesDefinition[];
     /** Display options of the primary query's series (AB#7952). */
     primarySeries: LineChartSeriesDisplayOptions | undefined;
+    /** Raw series group values left out of the chart (AB#8128). */
+    excludedSeriesGroupValues: string[];
+    /** Values of the series group field offered for exclusion (AB#8128). */
+    seriesGroupValues: string[];
+    isLoadingSeriesGroupValues: boolean;
+    /** The offered values could not be loaded; typed values still work. */
+    seriesGroupValuesFailed: boolean;
+    private seriesGroupValuesLoadToken;
+    /** Text typed into the Excluded series field; narrows the offered values. */
+    seriesGroupValueFilter: string;
+    /** The offered values that contain the typed text (case-insensitive). */
+    get filteredSeriesGroupValues(): string[];
     isLoadingInitial: boolean;
     isLoadingColumns: boolean;
     selectedPersistentQuery: PersistentQueryItem | null;
@@ -6334,13 +6367,21 @@ declare class LineChartConfigDialogComponent implements OnInit {
      * because the SD path has no dedicated column-introspection endpoint today.
      */
     private fetchColumnsForFamily;
+    /**
+     * 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.
+     */
+    loadSeriesGroupValues(): Promise<void>;
+    /** The author picked another series group field: the values excluded for the old field no longer apply. */
+    onSeriesGroupFieldChange(): Promise<void>;
     onFiltersChange(updatedFilters: FieldFilterItem[]): void;
     onSave(): void;
     addReferenceLine(): void;
     removeReferenceLine(index: number): void;
     onCancel(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<LineChartConfigDialogComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineChartConfigDialogComponent, "mm-line-chart-config-dialog", never, { "initialQueryRtId": { "alias": "initialQueryRtId"; "required": false; }; "initialQueryName": { "alias": "initialQueryName"; "required": false; }; "initialQueryFamily": { "alias": "initialQueryFamily"; "required": false; }; "initialIgnoreTimeFilter": { "alias": "initialIgnoreTimeFilter"; "required": false; }; "initialEntitySelectorId": { "alias": "initialEntitySelectorId"; "required": false; }; "initialResolutionAware": { "alias": "initialResolutionAware"; "required": false; }; "initialRequiredAggregation": { "alias": "initialRequiredAggregation"; "required": false; }; "initialChartType": { "alias": "initialChartType"; "required": false; }; "initialCategoryField": { "alias": "initialCategoryField"; "required": false; }; "initialSeriesGroupField": { "alias": "initialSeriesGroupField"; "required": false; }; "initialValueField": { "alias": "initialValueField"; "required": false; }; "initialUnitField": { "alias": "initialUnitField"; "required": false; }; "initialShowLegend": { "alias": "initialShowLegend"; "required": false; }; "initialLegendPosition": { "alias": "initialLegendPosition"; "required": false; }; "initialShowMarkers": { "alias": "initialShowMarkers"; "required": false; }; "initialShowDataBadge": { "alias": "initialShowDataBadge"; "required": false; }; "initialReferenceLines": { "alias": "initialReferenceLines"; "required": false; }; "initialFilters": { "alias": "initialFilters"; "required": false; }; "initialAdditionalSeries": { "alias": "initialAdditionalSeries"; "required": false; }; "initialStacked": { "alias": "initialStacked"; "required": false; }; "initialPrimarySeries": { "alias": "initialPrimarySeries"; "required": false; }; "initialBucketMinutes": { "alias": "initialBucketMinutes"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineChartConfigDialogComponent, "mm-line-chart-config-dialog", never, { "initialQueryRtId": { "alias": "initialQueryRtId"; "required": false; }; "initialQueryName": { "alias": "initialQueryName"; "required": false; }; "initialQueryFamily": { "alias": "initialQueryFamily"; "required": false; }; "initialIgnoreTimeFilter": { "alias": "initialIgnoreTimeFilter"; "required": false; }; "initialEntitySelectorId": { "alias": "initialEntitySelectorId"; "required": false; }; "initialResolutionAware": { "alias": "initialResolutionAware"; "required": false; }; "initialRequiredAggregation": { "alias": "initialRequiredAggregation"; "required": false; }; "initialChartType": { "alias": "initialChartType"; "required": false; }; "initialCategoryField": { "alias": "initialCategoryField"; "required": false; }; "initialSeriesGroupField": { "alias": "initialSeriesGroupField"; "required": false; }; "initialValueField": { "alias": "initialValueField"; "required": false; }; "initialUnitField": { "alias": "initialUnitField"; "required": false; }; "initialShowLegend": { "alias": "initialShowLegend"; "required": false; }; "initialLegendPosition": { "alias": "initialLegendPosition"; "required": false; }; "initialShowMarkers": { "alias": "initialShowMarkers"; "required": false; }; "initialShowDataBadge": { "alias": "initialShowDataBadge"; "required": false; }; "initialReferenceLines": { "alias": "initialReferenceLines"; "required": false; }; "initialFilters": { "alias": "initialFilters"; "required": false; }; "initialAdditionalSeries": { "alias": "initialAdditionalSeries"; "required": false; }; "initialStacked": { "alias": "initialStacked"; "required": false; }; "initialPrimarySeries": { "alias": "initialPrimarySeries"; "required": false; }; "initialBucketMinutes": { "alias": "initialBucketMinutes"; "required": false; }; "initialExcludedSeriesGroupValues": { "alias": "initialExcludedSeriesGroupValues"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 /**