@meshmakers/octo-meshboard 3.4.210 → 3.4.230

package/package.json

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

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

@@ -161,6 +161,28 @@ interface ProcessWidgetConfig extends WidgetConfig, ProcessWidgetSpecificConfig
      * Display name of the persistent query (for UI)
      */
     bindingQueryName?: string;
+    /**
+     * Query family of the bound persistent query: `'runtime'` or `'streamData'`.
+     * Derived from the query's `queryCkTypeId` when absent (one-time lookup by the
+     * executor). Persisted so a stream-data binding picks the correct executor
+     * without an extra round-trip — switching runtime ↔ stream-data is a config
+     * change, not a different widget.
+     */
+    bindingQueryFamily?: QueryFamily;
+    /**
+     * Stream-data opt-out: when `true`, the MeshBoard time filter is NOT bound to
+     * the bound query's `streamDataArgs.from/.to`, so the query's intrinsic time
+     * bounds win. Default (absent/`false`) auto-binds the active time filter.
+     * Ignored for runtime queries (they don't consume `streamDataArgs`).
+     */
+    bindingIgnoreTimeFilter?: boolean;
+    /**
+     * Asset-scope binding: the `id` of an entity selector whose selection scopes
+     * the bound stream-data query. The selector's resolved source rtIds are passed
+     * as `streamDataArgs.rtIds`, replacing the persisted scope at execution time.
+     * Ignored for runtime queries.
+     */
+    bindingEntitySelectorId?: string;
     /**
      * Field filters applied to the data binding query
      * Works with both runtimeEntity and persistentQuery modes
@@ -202,10 +224,27 @@ interface WidgetDataSource {
  */
 interface RuntimeEntityDataSource extends WidgetDataSource {
     type: 'runtimeEntity';
+    /**
+     * CK type of the entity. May contain a MeshBoard variable (e.g.
+     * `$mp_rtCkTypeId`) which is resolved against the active variables before the
+     * entity is fetched.
+     */
     ckTypeId?: string;
+    /**
+     * Runtime id of the entity. May contain a MeshBoard variable (e.g. `$mp_rtId`)
+     * which is resolved against the active variables before the entity is fetched.
+     */
     rtId?: string;
     attributePaths?: string[];
     includeAssociations?: boolean;
+    /**
+     * Entity-selector binding: the `id` of a MeshBoard entity selector whose
+     * current selection supplies this widget's entity. When set, the selector's
+     * `selectedRtId` and the picked entity's CK type (`$<id>_rtCkTypeId`) override
+     * `rtId`/`ckTypeId`, so the widget follows the asset picked at board level.
+     * Absent ⇒ the literal (optionally variable-bearing) `rtId`/`ckTypeId` win.
+     */
+    entitySelectorId?: string;
 }
 /**
  * Static data source for demo/testing or variable-based display
@@ -719,6 +758,48 @@ interface HeatmapWidgetConfig extends WidgetConfig {
     /** Field filters for data source */
     filters?: WidgetFilterConfig[];
 }
+/**
+ * Query mode for a persistent-query cell source — how the single displayed value
+ * is derived from the query result. Mirrors the KPI/gauge widget query modes.
+ */
+type PersistentQueryCellMode = 'simpleCount' | 'aggregation' | 'groupedAggregation';
+/**
+ * A single-value data source backed by a persistent query (runtime OR stream-data).
+ *
+ * Used per-cell by aggregation-style widgets (stats-grid stat, summary-card tile)
+ * as an alternative to their built-in runtime aggregation source. Switching a cell
+ * between runtime and stream-data is a configuration change (the `queryFamily`
+ * discriminator picks the executor), not a different widget — mirroring how the
+ * KPI/gauge widgets consume {@link PersistentQueryDataSource}.
+ */
+interface PersistentQueryCellSource {
+    /** The rtId of the persistent query to execute. */
+    queryRtId: string;
+    /** Display name of the query (for UI). */
+    queryName?: string;
+    /** Query family: 'runtime' or 'streamData'. Derived from the query's CK type when absent. */
+    queryFamily?: QueryFamily;
+    /**
+     * Stream-data opt-out: when `true`, the MeshBoard time filter is NOT bound to
+     * the query's `streamDataArgs.from/.to`. Ignored for runtime queries.
+     */
+    ignoreTimeFilter?: boolean;
+    /**
+     * Asset-scope binding: the `id` of an entity selector whose selection scopes the
+     * stream-data query via `streamDataArgs.rtIds`. Ignored for runtime queries.
+     */
+    entitySelectorId?: string;
+    /** How to reduce the query result to one value. */
+    queryMode: PersistentQueryCellMode;
+    /** Value column for `aggregation` / `groupedAggregation` modes. */
+    queryValueField?: string;
+    /** Category column for `groupedAggregation` mode. */
+    queryCategoryField?: string;
+    /** Category value to match for `groupedAggregation` mode. */
+    queryCategoryValue?: string;
+    /** Field filters applied to the query rows. */
+    filters?: WidgetFilterConfig[];
+}
 /**
  * Color options for stat items
  */
@@ -729,8 +810,16 @@ type StatColor = 'mint' | 'cyan' | 'violet' | 'toffee' | 'lilac' | 'bubblegum' |
 interface StatItem {
     /** Display label */
     label: string;
-    /** Reference to aggregation query ID */
+    /**
+     * Reference to the aggregation query ID in the widget's `AggregationDataSource`.
+     * Used when `persistentQuerySource` is absent (the default runtime aggregation).
+     */
     queryId: string;
+    /**
+     * Optional per-stat persistent-query source (runtime or stream-data). When set,
+     * it supersedes `queryId` / the aggregation source for this stat.
+     */
+    persistentQuerySource?: PersistentQueryCellSource;
     /** Color variant */
     color?: StatColor;
     /** Number format */
@@ -911,6 +1000,11 @@ interface SummaryCardTile {
         attribute?: string;
         filters?: WidgetFilterConfig[];
     };
+    /**
+     * Fetch a single value from a persistent query (runtime or stream-data). When
+     * set, it supersedes `entitySource` / `aggregationSource` for this tile.
+     */
+    persistentQuerySource?: PersistentQueryCellSource;
 }
 interface AlertBannerWidgetConfig extends WidgetConfig {
     type: 'alertBanner';
@@ -996,6 +1090,22 @@ type TimeRangeType = 'year' | 'quarter' | 'month' | 'day' | 'relative' | 'custom
  * Time units for relative time ranges
  */
 type RelativeTimeUnit = 'hours' | 'days' | 'weeks' | 'months';
+/**
+ * Timezone basis the MeshBoard uses for BOTH the time-filter boundary
+ * computation and the display of every datetime value across all widgets.
+ *
+ * - `'local'` (default): the browser's local timezone. "Year 2026" spans the
+ *   local calendar year and datetime cells render in local wall-clock time.
+ * - `'utc'`: UTC. "Year 2026" spans the UTC calendar year and datetime cells
+ *   render in UTC.
+ *
+ * Keeping filter and display on the same basis avoids the boundary artifact
+ * where a local-year filter selects rows whose UTC timestamps fall in the
+ * neighbouring calendar year. Mirrors shared-ui's `TimeRangeZone`.
+ */
+type MeshBoardTimeZoneMode = 'local' | 'utc';
+/** The board-level default timezone mode applied when none is persisted. */
+declare const DEFAULT_TIME_ZONE_MODE: MeshBoardTimeZoneMode;
 /**
  * Quarter number (1-4)
  */
@@ -1128,6 +1238,11 @@ interface MeshBoardConfig {
     variables?: MeshBoardVariable[];
     /** Optional time filter configuration */
     timeFilter?: MeshBoardTimeFilterConfig;
+    /**
+     * Timezone basis for time-filter boundaries and datetime display across all
+     * widgets. `undefined` ⇒ {@link DEFAULT_TIME_ZONE_MODE} (`'local'`).
+     */
+    timeZoneMode?: MeshBoardTimeZoneMode;
     /** Entity selector configurations for the toolbar */
     entitySelectors?: EntitySelectorConfig[];
     /**
@@ -1640,6 +1755,12 @@ declare class MeshBoardStateService {
     readonly widgets: _angular_core.Signal<AnyWidgetConfig[]>;
     readonly isModelAvailable: _angular_core.Signal<boolean | null>;
     readonly variableResolutionErrors: _angular_core.Signal<VariableResolutionError[]>;
+    /**
+     * The board's effective timezone mode (defaults to `'local'`). Drives both the
+     * time-filter boundary computation and datetime display across all widgets.
+     * Widgets read this to format timestamps consistently with the active filter.
+     */
+    readonly timeZoneMode: _angular_core.Signal<MeshBoardTimeZoneMode>;
     /** @deprecated Use meshBoardConfig instead */
     readonly dashboardConfig: _angular_core.Signal<MeshBoardConfig>;
     /** @deprecated Use persistedMeshBoardId instead */
@@ -1716,6 +1837,7 @@ declare class MeshBoardStateService {
         gap: number;
         variables?: MeshBoardVariable[];
         timeFilter?: MeshBoardTimeFilterConfig;
+        timeZoneMode?: MeshBoardTimeZoneMode;
         entitySelectors?: EntitySelectorConfig[];
         autoRefreshSeconds?: number;
     }): void;
@@ -1731,6 +1853,7 @@ declare class MeshBoardStateService {
         gap: number;
         variables: MeshBoardVariable[];
         timeFilter?: MeshBoardTimeFilterConfig;
+        timeZoneMode?: MeshBoardTimeZoneMode;
         entitySelectors?: EntitySelectorConfig[];
         autoRefreshSeconds?: number;
     };
@@ -1809,8 +1932,9 @@ declare class MeshBoardStateService {
      * Stream-data persistent queries consume this to bound their result set;
      * runtime queries ignore it.
      *
-     * IANA-timezone-aware bucket boundaries are tracked separately (AB#4190);
-     * this helper currently returns UTC boundaries derived from the picker.
+     * Boundaries are resolved on the board's {@link timeZoneMode} basis (local by
+     * default, or UTC), the same basis widgets format their datetime display on —
+     * so the selected range and the displayed timestamps stay consistent.
      */
     resolveCurrentTimeRange(): TimeRange | null;
     /**
@@ -2447,19 +2571,17 @@ declare const DashboardGridService: typeof MeshBoardGridService;
  * without importing generated DTO types directly.
  *
  * Backend semantics (verified against StreamDataQueryDtoType.cs and
- * StreamDataVariantExecutor.cs as of 2026-06-24):
+ * StreamDataVariantExecutor.cs; `queryMode` override added in AB#4233):
  * - `from` / `to` / `limit` override the persisted query's intrinsic values
  *   when set (`execOverride?.From ?? simple.From` pattern in the resolver).
  * - `interval` is currently ignored by every variant; the downsampling path
  *   derives `(to - from) / limit` itself.
- * - `queryMode` is **ignored on both persistent and transient dispatch** —
- *   the variant (Simple / Aggregation / GroupingAggregation / Downsampling)
- *   comes from the persisted entity's CK subtype or the transient query's
- *   GraphQL sub-connection URL. We still emit it because the schema declares
- *   `queryMode: QueryMode!` (NonNull); see backend cleanup issue.
- *
- * Don't pretend to override the mode from here — even if `queryMode: DOWNSAMPLING`
- * is set on a `SimpleSdQuery`, the backend still runs the simple variant.
+ * - `queryMode: DOWNSAMPLING` on a `SimpleSdQuery` (persisted) or the transient
+ *   `simple` sub-connection now drives the downsampling execution path: with a
+ *   full from/to/limit contract the backend reduces to `limit` buckets per series
+ *   (per-type reducers + group-by source rtId). Without all three it falls back
+ *   to raw rows. For the other variants the execution shape still comes from the
+ *   CK subtype / sub-connection; `queryMode` is a no-op there.
  */
 interface StreamDataExecutionArgs {
     from?: Date | null;
@@ -2467,8 +2589,9 @@ interface StreamDataExecutionArgs {
     interval?: number | null;
     limit?: number | null;
     /**
-     * Currently a no-op on the dispatch side; kept because the GraphQL input
-     * schema marks `queryMode` non-null. Defaults to `Default`.
+     * `DOWNSAMPLING` switches a SimpleSdQuery / transient `simple` query to the
+     * downsampling path (with from/to/limit); a no-op for the other variants.
+     * Defaults to `Default` (raw rows).
      */
     queryMode?: QueryModeDto;
     /**
@@ -2610,6 +2733,8 @@ declare class AutoRefreshTimerService implements OnDestroy {
 
 declare class EntityCardWidgetComponent implements DashboardWidget<EntityCardWidgetConfig, RuntimeEntityData>, OnInit, OnChanges {
     private readonly dataService;
+    private readonly stateService;
+    private readonly variableService;
     config: EntityCardWidgetConfig;
     private readonly _isLoading;
     private readonly _data;
@@ -2635,18 +2760,47 @@ declare class EntityCardWidgetComponent implements DashboardWidget<EntityCardWid
     ngOnChanges(changes: SimpleChanges): void;
     refresh(): void;
     private loadData;
+    /**
+     * Message for the neutral empty state — shown when the widget IS configured
+     * but no entity is currently resolved (e.g. a bound selector hasn't been
+     * picked yet, or a variable is still unresolved). This is deliberately not the
+     * red "not configured" placeholder, which would wrongly imply the widget needs
+     * setup.
+     */
+    emptyMessage(): string;
+    /**
+     * Resolves the effective `{ rtId, ckTypeId }` to fetch from a runtime-entity
+     * data source.
+     *
+     * - When `entitySelectorId` is set, the bound MeshBoard entity selector's
+     *   current `selectedRtId` and the picked entity's type
+     *   (`$<selectorId>_rtCkTypeId`, falling back to the selector's configured
+     *   `ckTypeId`) win — so the card follows the asset picked at board level.
+     * - Otherwise the configured `rtId`/`ckTypeId` are resolved against the active
+     *   MeshBoard variables, allowing values like `$mp_rtId` / `$mp_rtCkTypeId`.
+     */
+    private resolveEntityRef;
     inferAttributeType(value: unknown): AttributeValueTypeDto;
     formatAttributeName(name: string): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EntityCardWidgetComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EntityCardWidgetComponent, "mm-entity-card-widget", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, true, never>;
 }
 
+/** How the entity card resolves which entity to display. */
+type EntityCardBindingMode = 'fixed' | 'selector' | 'variable';
 /**
- * Configuration result from the dialog
+ * Configuration result from the dialog.
+ *
+ * - `fixed` mode  → `ckTypeId`/`rtId` hold a concrete type + entity.
+ * - `selector` mode → `entitySelectorId` names a board-level entity selector;
+ *   `ckTypeId`/`rtId` are empty (resolved live from the selection).
+ * - `variable` mode → `ckTypeId`/`rtId` hold MeshBoard variables (e.g.
+ *   `$mp_rtCkTypeId` / `$mp_rtId`) resolved at render time.
  */
 interface EntityCardConfigResult {
     ckTypeId: string;
     rtId: string;
+    entitySelectorId?: string;
     hideEmptyAttributes: boolean;
 }
 /**
@@ -2656,20 +2810,28 @@ interface EntityCardConfigResult {
 declare class EntityCardConfigDialogComponent implements OnInit {
     private readonly getEntitiesByCkTypeGQL;
     private readonly ckTypeSelectorService;
+    private readonly stateService;
     private readonly windowRef;
     ckTypeSelectorInput?: CkTypeSelectorInputComponent;
     entitySelectorInput?: EntitySelectInputComponent;
     initialCkTypeId?: string;
     initialRtId?: string;
+    initialEntitySelectorId?: string;
     initialHideEmptyAttributes: boolean;
+    bindingMode: EntityCardBindingMode;
     selectedCkType: CkTypeSelectorItem | null;
     selectedEntity: RuntimeEntityItem$1 | null;
     entityDataSource?: RuntimeEntitySelectDataSource$1;
     entityDialogDataSource?: RuntimeEntityDialogDataSource$1;
     isLoadingInitial: boolean;
     hideEmptyAttributes: boolean;
+    entitySelectorId: string;
+    variableCkTypeId: string;
+    variableRtId: string;
+    get availableSelectors(): EntitySelectorConfig[];
     get isValid(): boolean;
     ngOnInit(): Promise<void>;
+    private containsVariable;
     private loadInitialValues;
     private loadInitialEntity;
     onCkTypeSelected(ckType: CkTypeSelectorItem): void;
@@ -2679,7 +2841,7 @@ declare class EntityCardConfigDialogComponent implements OnInit {
     onSave(): void;
     onCancel(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EntityCardConfigDialogComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EntityCardConfigDialogComponent, "mm-entity-card-config-dialog", never, { "initialCkTypeId": { "alias": "initialCkTypeId"; "required": false; }; "initialRtId": { "alias": "initialRtId"; "required": false; }; "initialHideEmptyAttributes": { "alias": "initialHideEmptyAttributes"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EntityCardConfigDialogComponent, "mm-entity-card-config-dialog", never, { "initialCkTypeId": { "alias": "initialCkTypeId"; "required": false; }; "initialRtId": { "alias": "initialRtId"; "required": false; }; "initialEntitySelectorId": { "alias": "initialEntitySelectorId"; "required": false; }; "initialHideEmptyAttributes": { "alias": "initialHideEmptyAttributes"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 declare class KpiWidgetComponent implements DashboardWidget<KpiWidgetConfig, RuntimeEntityData>, OnInit, OnChanges {
@@ -2914,6 +3076,7 @@ interface TargetEntity {
 }
 declare class EntityAssociationsWidgetComponent implements DashboardWidget<EntityWithAssociationsWidgetConfig, RuntimeEntityData>, OnInit, OnChanges {
     private readonly dataService;
+    private readonly stateService;
     config: EntityWithAssociationsWidgetConfig;
     protected readonly arrowRightIcon: _progress_kendo_svg_icons.SVGIcon;
     protected readonly arrowLeftIcon: _progress_kendo_svg_icons.SVGIcon;
@@ -3243,6 +3406,7 @@ declare class TableWidgetDataSourceDirective extends OctoGraphQlDataSource<Recor
 declare class TableWidgetComponent implements DashboardWidget<TableWidgetConfig, Record<string, unknown>[]>, OnChanges {
     config: TableWidgetConfig;
     dataSource?: TableWidgetDataSourceDirective;
+    private readonly stateService;
     private readonly _isLoading;
     private readonly _data;
     private readonly _error;
@@ -4073,6 +4237,8 @@ declare class LineChartWidgetComponent implements DashboardWidget<LineChartWidge
     private formatDate;
     /**
      * Formats a date with time for display on the category axis.
+     * Date and time parts are formatted separately (joined with a space) to keep
+     * the compact axis label; both honor the board's timezone mode.
      */
     private formatDateTime;
     private sanitizeAxisName;
@@ -4259,7 +4425,6 @@ declare class HeatmapWidgetComponent implements DashboardWidget<HeatmapWidgetCon
     private assignColors;
     private aggregate;
     private parseDate;
-    private formatDateKey;
     private convertFiltersToDto;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<HeatmapWidgetComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<HeatmapWidgetComponent, "mm-heatmap-widget", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, true, never>;
@@ -4378,6 +4543,9 @@ interface StatValue {
 }
 declare class StatsGridWidgetComponent implements OnInit, OnChanges {
     private readonly dataService;
+    private readonly queryExecutor;
+    private readonly stateService;
+    private readonly variableService;
     config: StatsGridWidgetConfig;
     private readonly _isLoading;
     private readonly _error;
@@ -4394,6 +4562,14 @@ declare class StatsGridWidgetComponent implements OnInit, OnChanges {
     ngOnChanges(changes: SimpleChanges): void;
     refresh(): void;
     private loadData;
+    /**
+     * Resolves a single stat's value: a per-stat persistent query (runtime or
+     * stream-data) when configured, otherwise the runtime aggregation result.
+     */
+    private resolveStatValue;
+    private loadPersistentQueryValue;
+    private buildStreamDataArgs;
+    private convertFiltersToDto;
     private getColorClass;
     formatValue(stat: StatValue): string;
     get gridColumns(): number;
@@ -4407,6 +4583,7 @@ interface StatsGridConfigResult extends WidgetConfigResult {
     queries: AggregationQuery[];
     columns: number;
 }
+type StatSourceType = 'aggregation' | 'persistentQuery';
 interface ColorOption {
     value: StatColor;
     label: string;
@@ -4419,17 +4596,25 @@ interface CkTypeOption {
 interface EditableStat {
     id: string;
     label: string;
+    sourceType: StatSourceType;
     ckTypeId: string;
     aggregation: AggregationType;
+    persistentQuerySource?: PersistentQueryCellSource;
     color: StatColor;
     prefix?: string;
     suffix?: string;
 }
 declare class StatsGridConfigDialogComponent implements OnInit {
     private readonly windowRef;
+    private readonly stateService;
     initialStats?: StatItem[];
     initialQueries?: AggregationQuery[];
     initialColumns?: number;
+    entitySelectors: EntitySelectorConfig[];
+    sourceTypeOptions: {
+        value: StatSourceType;
+        label: string;
+    }[];
     colorOptions: ColorOption[];
     ckTypeOptions: CkTypeOption[];
     filteredCkTypeOptions: CkTypeOption[];
@@ -4914,6 +5099,9 @@ interface TileValue {
 declare class SummaryCardWidgetComponent implements DashboardWidget<SummaryCardWidgetConfig, TileValue[]>, OnInit, OnChanges {
     private readonly entityGQL;
     private readonly dataService;
+    private readonly queryExecutor;
+    private readonly stateService;
+    private readonly variableService;
     config: SummaryCardWidgetConfig;
     private readonly _isLoading;
     private readonly _error;
@@ -4928,6 +5116,9 @@ declare class SummaryCardWidgetComponent implements DashboardWidget<SummaryCardW
     refresh(): void;
     private loadData;
     private fetchTileValue;
+    private fetchPersistentQueryValue;
+    private buildStreamDataArgs;
+    private convertFiltersToDto;
     private fetchEntityAttributes;
     private formatValue;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SummaryCardWidgetComponent, never>;
@@ -4938,6 +5129,7 @@ interface SummaryCardConfigResult extends WidgetConfigResult {
     columns: number;
     tiles: SummaryCardTile[];
 }
+type TileSourceType = 'entity' | 'aggregation' | 'persistentQuery';
 interface EditableTile {
     id: string;
     label: string;
@@ -4945,24 +5137,27 @@ interface EditableTile {
     suffix: string;
     color: string;
     size: string;
-    sourceType: 'entity' | 'aggregation';
+    sourceType: TileSourceType;
     rtId: string;
     ckTypeId: string;
     attributePath: string;
     aggregation: string;
     aggAttribute: string;
+    persistentQuerySource?: PersistentQueryCellSource;
 }
 declare class SummaryCardConfigDialogComponent implements OnInit {
     private readonly windowRef;
+    private readonly stateService;
     initialColumns?: number;
     initialTiles?: SummaryCardTile[];
+    entitySelectors: EntitySelectorConfig[];
     form: {
         columns: number;
         tiles: EditableTile[];
     };
     colorOptions: string[];
     sizeOptions: string[];
-    sourceTypeOptions: string[];
+    sourceTypeOptions: TileSourceType[];
     aggregationOptions: string[];
     get isValid(): boolean;
     ngOnInit(): void;
@@ -5032,6 +5227,7 @@ declare class AlertBannerConfigDialogComponent {
 
 declare class AlertListWidgetComponent implements DashboardWidget<AlertListWidgetConfig, AlertItem[]>, OnInit, OnChanges {
     private readonly getEntitiesByCkTypeGQL;
+    private readonly stateService;
     config: AlertListWidgetConfig;
     private readonly _isLoading;
     private readonly _error;
@@ -5604,6 +5800,13 @@ declare class MeshBoardViewComponent implements OnInit, OnDestroy, HasUnsavedCha
      * URL params take precedence over stored selection to support page reload.
      */
     private initializeTimeFilterVariables;
+    /**
+     * Recomputes the active time-filter range from the current selection on the
+     * board's (possibly just-changed) timezone mode and republishes the
+     * `$timeRangeFrom`/`$timeRangeTo` variables. No-op when the filter is
+     * disabled or no selection is active.
+     */
+    private reapplyTimeFilterRange;
     /**
      * Converts a TimeRangeSelection to a SharedTimeRangeSelection.
      */
@@ -5836,7 +6039,8 @@ declare class MeshBoardSettingsResult {
     rtWellKnownName?: string | undefined;
     entitySelectors?: EntitySelectorConfig[] | undefined;
     autoRefreshSeconds?: number | undefined;
-    constructor(name: string, description: string, columns: number, rowHeight: number, gap: number, variables: MeshBoardVariable[], timeFilter?: MeshBoardTimeFilterConfig | undefined, rtWellKnownName?: string | undefined, entitySelectors?: EntitySelectorConfig[] | undefined, autoRefreshSeconds?: number | undefined);
+    timeZoneMode?: MeshBoardTimeZoneMode | undefined;
+    constructor(name: string, description: string, columns: number, rowHeight: number, gap: number, variables: MeshBoardVariable[], timeFilter?: MeshBoardTimeFilterConfig | undefined, rtWellKnownName?: string | undefined, entitySelectors?: EntitySelectorConfig[] | undefined, autoRefreshSeconds?: number | undefined, timeZoneMode?: MeshBoardTimeZoneMode | undefined);
 }
 /**
  * Dialog for editing MeshBoard settings.
@@ -5862,6 +6066,11 @@ declare class MeshBoardSettingsDialogComponent {
     timeFilterEnabled: boolean;
     defaultSelection?: TimeRangeSelection;
     initialDefaultSelection?: TimeRangeSelection$1;
+    /**
+     * Timezone basis for time-filter boundaries and datetime display across all
+     * widgets. Defaults to `'local'` (browser timezone).
+     */
+    timeZoneMode: MeshBoardTimeZoneMode;
     /** Static and time filter variable names for duplicate detection in entity selector editor */
     get staticVariableNames(): string[];
     get isValid(): boolean;
@@ -5877,6 +6086,7 @@ declare class MeshBoardSettingsDialogComponent {
         gap: number;
         variables?: MeshBoardVariable[];
         timeFilter?: MeshBoardTimeFilterConfig;
+        timeZoneMode?: MeshBoardTimeZoneMode;
         entitySelectors?: EntitySelectorConfig[];
         autoRefreshSeconds?: number;
     }): void;
@@ -6075,5 +6285,5 @@ declare class MeshBoardManagerDialogComponent implements OnInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MeshBoardManagerDialogComponent, "mm-meshboard-manager-dialog", never, {}, {}, never, never, true, never>;
 }
 
-export { AddWidgetDialogComponent, AiInsightsConfigDialogComponent, AiInsightsService, AiInsightsWidgetComponent, AlertBannerConfigDialogComponent, AlertBannerWidgetComponent, AlertListConfigDialogComponent, AlertListWidgetComponent, AssociationsConfigDialogComponent, AutoRefreshTimerService, BarChartConfigDialogComponent, BarChartWidgetComponent, DashboardDataService, DashboardGridService, EditModeStateService, EditWidgetDialogComponent, EntityAssociationsWidgetComponent, EntityCardConfigDialogComponent, EntityCardWidgetComponent, EntityDetailDialogComponent, EntitySelectorEditorComponent, EntitySelectorToolbarComponent, GaugeConfigDialogComponent, GaugeWidgetComponent, HeatmapConfigDialogComponent, HeatmapWidgetComponent, KpiConfigDialogComponent, KpiWidgetComponent, LineChartConfigDialogComponent, LineChartWidgetComponent, MESHBOARD_OPTIONS, MESHBOARD_TENANT_ID_PROVIDER, MarkdownConfigDialogComponent, MarkdownWidgetComponent, MeshBoardDataService, MeshBoardGridService, MeshBoardManagerDialogComponent, MeshBoardPersistenceService, MeshBoardSettingsDialogComponent, MeshBoardSettingsResult, MeshBoardStateService, MeshBoardViewComponent, PieChartConfigDialogComponent, PieChartWidgetComponent, QueryExecutorService, QuerySelectorComponent, RuntimeEntitySelectorComponent, ServiceHealthConfigDialogComponent, ServiceHealthWidgetComponent, StatsGridConfigDialogComponent, StatsGridWidgetComponent, StatusIndicatorConfigDialogComponent, StatusIndicatorWidgetComponent, StatusListConfigDialogComponent, StatusListWidgetComponent, SummaryCardConfigDialogComponent, SummaryCardWidgetComponent, TableConfigDialogComponent, TableWidgetComponent, TableWidgetDataSourceDirective, WidgetFactoryService, WidgetGroupComponent, WidgetGroupConfigDialogComponent, WidgetNotConfiguredComponent, WidgetRegistryService, classifyQuery, provideDefaultWidgets, provideMeshBoard, provideProcessWidget, provideWidgetRegistrations, queryFamily, registerDefaultWidgets, registerProcessWidget };
-export type { AggregationDataSource, AggregationQuery, AggregationType, AiInsightsConfigResult, AiInsightsWidgetConfig, AlertBannerConfigResult, AlertBannerWidgetConfig, AlertListConfigResult, AlertListWidgetConfig, AnyWidgetConfig, AssociationsConfigResult, BarChartColorThreshold, BarChartConfigResult, BarChartSeries, BarChartType, BarChartWidgetConfig, BaseWidgetConfig, CategoryValueItem, ChartReferenceLine, CkQueryResult, CkQueryTarget, CkTypeAttributeInfo, ConfigDialogResult, ConfigResultApplier, ConstructionKitQueryDataSource, DashboardConfig, DashboardWidget, DataSource, DataSourceType, DiagramPropertyMapping, EntityAssociation, EntityAttribute, EntityCardConfigResult, EntityCardWidgetConfig, EntityListWidget, EntitySelectorAttributeMapping, EntitySelectorChildScope, EntitySelectorClearEvent, EntitySelectorConfig, EntitySelectorEvent, EntityWidget, EntityWithAssociationsWidgetConfig, GaugeConfigResult, GaugeRange, GaugeType, GaugeWidgetConfig, GridCell, GridPosition, GroupChildWidgetType, GroupedDataItem, HeatmapAggregation, HeatmapColorScheme, HeatmapConfigResult, HeatmapWidgetConfig, KpiConfigResult, KpiDataSourceType, KpiQueryMode, KpiWidgetConfig, LineChartConfigResult, LineChartType, LineChartWidgetConfig, MarkdownConfigResult, MarkdownTextAlign, MarkdownWidgetConfig, MeshBoardConfig, MeshBoardOptions, MeshBoardTimeFilterConfig, MeshBoardVariable, MeshBoardVariableSource, MeshBoardVariableType, ParentAssociationMode, PersistedDashboard, PersistedMeshBoard, PersistedWidget, PersistedWidgetData, PersistentQueryDataSource, PersistentQueryItem, PieChartConfigResult, PieChartType, PieChartWidgetConfig, ProcessWidgetConfig, Quarter, QueryCell, QueryClassification, QueryColumn, QueryColumnInfo, QueryColumnItem, QueryExecutionOptions, QueryExecutionResult, QueryFamily, QueryKind, QueryResultRow, RelativeTimeUnit, RepeaterDataItem, RepeaterQueryDataSource, RuntimeEntityData, RuntimeEntityDataSource, RuntimeEntitySelectorValue, ServiceCallDataSource, ServiceCallType, ServiceHealthConfigResult, ServiceHealthWidgetConfig, StatColor, StatItem, StaticDataSource, StatsGridConfigResult, StatsGridWidgetConfig, StatusIndicatorConfigResult, StatusIndicatorWidgetConfig, StatusListConfigResult, StatusListWidgetConfig, StreamDataExecutionArgs, SummaryCardConfigResult, SummaryCardTile, SummaryCardWidgetConfig, TableColumn, TableColumnStatusIconMapping, TableConfigResult, TableFilterConfig, TableSortConfig, TableWidgetConfig, TargetEntityWithAttributes, TimeRangePickerConfig, TimeRangeSelection, TimeRangeType, UpdateDashboardResult, VariableResolutionError, WidgetConfig, WidgetConfigDialog, WidgetConfigDialogSize, WidgetConfigResult, WidgetCreationOptions, WidgetDataSource, WidgetFilterConfig, WidgetGroupAttributeMappings, WidgetGroupChildTemplate, WidgetGroupConfig, WidgetGroupConfigResult, WidgetGroupLayout, WidgetPersistenceData, WidgetPositionUpdate, WidgetRegistration, WidgetType, WidgetZone };
+export { AddWidgetDialogComponent, AiInsightsConfigDialogComponent, AiInsightsService, AiInsightsWidgetComponent, AlertBannerConfigDialogComponent, AlertBannerWidgetComponent, AlertListConfigDialogComponent, AlertListWidgetComponent, AssociationsConfigDialogComponent, AutoRefreshTimerService, BarChartConfigDialogComponent, BarChartWidgetComponent, DEFAULT_TIME_ZONE_MODE, DashboardDataService, DashboardGridService, EditModeStateService, EditWidgetDialogComponent, EntityAssociationsWidgetComponent, EntityCardConfigDialogComponent, EntityCardWidgetComponent, EntityDetailDialogComponent, EntitySelectorEditorComponent, EntitySelectorToolbarComponent, GaugeConfigDialogComponent, GaugeWidgetComponent, HeatmapConfigDialogComponent, HeatmapWidgetComponent, KpiConfigDialogComponent, KpiWidgetComponent, LineChartConfigDialogComponent, LineChartWidgetComponent, MESHBOARD_OPTIONS, MESHBOARD_TENANT_ID_PROVIDER, MarkdownConfigDialogComponent, MarkdownWidgetComponent, MeshBoardDataService, MeshBoardGridService, MeshBoardManagerDialogComponent, MeshBoardPersistenceService, MeshBoardSettingsDialogComponent, MeshBoardSettingsResult, MeshBoardStateService, MeshBoardViewComponent, PieChartConfigDialogComponent, PieChartWidgetComponent, QueryExecutorService, QuerySelectorComponent, RuntimeEntitySelectorComponent, ServiceHealthConfigDialogComponent, ServiceHealthWidgetComponent, StatsGridConfigDialogComponent, StatsGridWidgetComponent, StatusIndicatorConfigDialogComponent, StatusIndicatorWidgetComponent, StatusListConfigDialogComponent, StatusListWidgetComponent, SummaryCardConfigDialogComponent, SummaryCardWidgetComponent, TableConfigDialogComponent, TableWidgetComponent, TableWidgetDataSourceDirective, WidgetFactoryService, WidgetGroupComponent, WidgetGroupConfigDialogComponent, WidgetNotConfiguredComponent, WidgetRegistryService, classifyQuery, provideDefaultWidgets, provideMeshBoard, provideProcessWidget, provideWidgetRegistrations, queryFamily, registerDefaultWidgets, registerProcessWidget };
+export type { AggregationDataSource, AggregationQuery, AggregationType, AiInsightsConfigResult, AiInsightsWidgetConfig, AlertBannerConfigResult, AlertBannerWidgetConfig, AlertListConfigResult, AlertListWidgetConfig, AnyWidgetConfig, AssociationsConfigResult, BarChartColorThreshold, BarChartConfigResult, BarChartSeries, BarChartType, BarChartWidgetConfig, BaseWidgetConfig, CategoryValueItem, ChartReferenceLine, CkQueryResult, CkQueryTarget, CkTypeAttributeInfo, ConfigDialogResult, ConfigResultApplier, ConstructionKitQueryDataSource, DashboardConfig, DashboardWidget, DataSource, DataSourceType, DiagramPropertyMapping, EntityAssociation, EntityAttribute, EntityCardConfigResult, EntityCardWidgetConfig, EntityListWidget, EntitySelectorAttributeMapping, EntitySelectorChildScope, EntitySelectorClearEvent, EntitySelectorConfig, EntitySelectorEvent, EntityWidget, EntityWithAssociationsWidgetConfig, GaugeConfigResult, GaugeRange, GaugeType, GaugeWidgetConfig, GridCell, GridPosition, GroupChildWidgetType, GroupedDataItem, HeatmapAggregation, HeatmapColorScheme, HeatmapConfigResult, HeatmapWidgetConfig, KpiConfigResult, KpiDataSourceType, KpiQueryMode, KpiWidgetConfig, LineChartConfigResult, LineChartType, LineChartWidgetConfig, MarkdownConfigResult, MarkdownTextAlign, MarkdownWidgetConfig, MeshBoardConfig, MeshBoardOptions, MeshBoardTimeFilterConfig, MeshBoardTimeZoneMode, MeshBoardVariable, MeshBoardVariableSource, MeshBoardVariableType, ParentAssociationMode, PersistedDashboard, PersistedMeshBoard, PersistedWidget, PersistedWidgetData, PersistentQueryCellMode, PersistentQueryCellSource, PersistentQueryDataSource, PersistentQueryItem, PieChartConfigResult, PieChartType, PieChartWidgetConfig, ProcessWidgetConfig, Quarter, QueryCell, QueryClassification, QueryColumn, QueryColumnInfo, QueryColumnItem, QueryExecutionOptions, QueryExecutionResult, QueryFamily, QueryKind, QueryResultRow, RelativeTimeUnit, RepeaterDataItem, RepeaterQueryDataSource, RuntimeEntityData, RuntimeEntityDataSource, RuntimeEntitySelectorValue, ServiceCallDataSource, ServiceCallType, ServiceHealthConfigResult, ServiceHealthWidgetConfig, StatColor, StatItem, StaticDataSource, StatsGridConfigResult, StatsGridWidgetConfig, StatusIndicatorConfigResult, StatusIndicatorWidgetConfig, StatusListConfigResult, StatusListWidgetConfig, StreamDataExecutionArgs, SummaryCardConfigResult, SummaryCardTile, SummaryCardWidgetConfig, TableColumn, TableColumnStatusIconMapping, TableConfigResult, TableFilterConfig, TableSortConfig, TableWidgetConfig, TargetEntityWithAttributes, TimeRangePickerConfig, TimeRangeSelection, TimeRangeType, UpdateDashboardResult, VariableResolutionError, WidgetConfig, WidgetConfigDialog, WidgetConfigDialogSize, WidgetConfigResult, WidgetCreationOptions, WidgetDataSource, WidgetFilterConfig, WidgetGroupAttributeMappings, WidgetGroupChildTemplate, WidgetGroupConfig, WidgetGroupConfigResult, WidgetGroupLayout, WidgetPersistenceData, WidgetPositionUpdate, WidgetRegistration, WidgetType, WidgetZone };