@c8y/ngx-components 1023.64.2 → 1023.65.0

package/fesm2022/c8y-ngx-components-global-context.mjs

@@ -1,7 +1,7 @@
 import { gettext } from '@c8y/ngx-components/gettext';
 import { aggregationType } from '@c8y/client';
 import * as i0 from '@angular/core';
-import { computed, signal, Injectable, inject, input, forwardRef, ChangeDetectionStrategy, Component, DestroyRef, output, Input, ChangeDetectorRef, ViewChild, EventEmitter, viewChild, effect, HostListener, Output, TemplateRef, untracked, ContentChild, NgModule } from '@angular/core';
+import { computed, signal, Injectable, inject, input, forwardRef, ChangeDetectionStrategy, Component, DestroyRef, output, Input, ChangeDetectorRef, ViewChild, EventEmitter, viewChild, effect, HostListener, Output, InjectionToken, TemplateRef, untracked, ContentChild, NgModule } from '@angular/core';
 import * as i4 from '@c8y/ngx-components';
 import { ViewContext, I18nModule, IconDirective, FormGroupComponent, MessagesComponent, MessageDirective, DateTimePickerModule, C8yTranslatePipe, DatePipe, TabsOutletComponent, FormsModule as FormsModule$1, CountdownIntervalModule, CountdownIntervalComponent, AlertService, ContextRouteService, DashboardChildComponent, hookActionBar } from '@c8y/ngx-components';
 import { BehaviorSubject, map, distinctUntilChanged, shareReplay, fromEvent, filter, debounceTime, startWith, tap as tap$1, firstValueFrom, combineLatest, Subject, take, skip, throttleTime, merge as merge$1, EMPTY } from 'rxjs';
@@ -5446,6 +5446,25 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.18", ngImpo
                 args: [ConfigurationCollapseComponent, { static: false }]
             }] } });
 
+/**
+ * Injection token for registering custom dashboard paths where Global Context should be displayed.
+ *
+ * Use this token to enable Global Context on named dashboard routes that don't have a
+ * `dashboardId` route parameter. Supports `multi: true` to allow multiple providers.
+ *
+ * @example
+ * ```typescript
+ * // In app.config.ts or module providers
+ * providers: [
+ *   {
+ *     provide: GLOBAL_CONTEXT_DASHBOARD_PATHS,
+ *     useValue: ['dashboard/my-custom-dashboard', 'dashboard/another-dashboard'],
+ *     multi: true
+ *   }
+ * ]
+ * ```
+ */
+const GLOBAL_CONTEXT_DASHBOARD_PATHS = new InjectionToken('GLOBAL_CONTEXT_DASHBOARD_PATHS');
 /**
  * Constants defining the supported route paths for global context integration.
  */
@@ -5508,6 +5527,11 @@ class GlobalContextNavigationService {
         this.contextRoute = inject(ContextRouteService);
         /** Angular router for navigation state access */
         this.router = inject(Router);
+        /**
+         * Custom dashboard paths registered via GLOBAL_CONTEXT_DASHBOARD_PATHS injection token.
+         * Flattened from multi-provider array.
+         */
+        this.registeredDashboardPaths = (inject(GLOBAL_CONTEXT_DASHBOARD_PATHS, { optional: true }) || []).flat();
         /** Signal storing the current global context instance configuration */
         this.instance = signal({
             ...DEFAULT_INSTANCE,
@@ -5665,7 +5689,10 @@ class GlobalContextNavigationService {
     /**
      * Handles navigation to dashboard routes.
      *
-     * Dashboard routes display global context only if a valid dashboard ID exists.
+     * Dashboard routes display global context if:
+     * - A valid dashboard ID exists in route params, OR
+     * - The route path is registered via GLOBAL_CONTEXT_DASHBOARD_PATHS token
+     *
      * Manages query parameter cleanup during dashboard transitions.
      *
      * @param activeRoute - The active route containing dashboard parameters
@@ -5673,16 +5700,20 @@ class GlobalContextNavigationService {
      */
     handleDashboard(activeRoute) {
         const dashboardId = this.extractDashboardId(activeRoute);
-        if (!dashboardId) {
+        // For named dashboards without dashboardId, check if path is registered
+        const routePath = this.extractRoutePath(activeRoute);
+        const isRegisteredPath = this.isRegisteredDashboardPath(routePath);
+        const effectiveId = dashboardId || (isRegisteredPath ? routePath : undefined);
+        if (!effectiveId) {
             return null;
         }
         const current = this.getInstance();
         // Return existing instance if same dashboard
-        if (current.source === ROUTE_PATHS.DASHBOARD && current.sourceId === dashboardId) {
+        if (current.source === ROUTE_PATHS.DASHBOARD && current.sourceId === effectiveId) {
             return current.actionBarItem;
         }
         // We're changing contexts if coming from a different dashboard
-        const isChangingContext = current.source === ROUTE_PATHS.DASHBOARD && current.sourceId !== dashboardId;
+        const isChangingContext = current.source === ROUTE_PATHS.DASHBOARD && current.sourceId !== effectiveId;
         this.handleQueryParamCleanup(isChangingContext);
         // Create new dashboard instance
         const dashboardInstance = {
@@ -5691,7 +5722,7 @@ class GlobalContextNavigationService {
                 placement: 'left'
             },
             source: ROUTE_PATHS.DASHBOARD,
-            sourceId: dashboardId
+            sourceId: effectiveId
         };
         this.instance.set(dashboardInstance);
         return this.getInstance().actionBarItem;
@@ -5740,6 +5771,31 @@ class GlobalContextNavigationService {
         const dashboardId = activeRoute?.snapshot?.params?.['dashboardId'];
         return dashboardId && typeof dashboardId === 'string' ? dashboardId : undefined;
     }
+    /**
+     * Extracts the full route path from URL segments.
+     *
+     * @param activeRoute - The route to extract path from
+     * @returns Full route path (e.g., 'dashboard/my-dashboard') or undefined
+     */
+    extractRoutePath(activeRoute) {
+        const segments = activeRoute?.snapshot?.url || [];
+        if (segments.length === 0) {
+            return undefined;
+        }
+        return segments.map(s => s.path).join('/');
+    }
+    /**
+     * Checks if a route path is registered as a custom dashboard path.
+     *
+     * @param routePath - The route path to check
+     * @returns True if the path is registered via GLOBAL_CONTEXT_DASHBOARD_PATHS
+     */
+    isRegisteredDashboardPath(routePath) {
+        if (!routePath || this.registeredDashboardPaths.length === 0) {
+            return false;
+        }
+        return this.registeredDashboardPaths.some(registeredPath => routePath === registeredPath || routePath.startsWith(registeredPath + '/'));
+    }
     /**
      * Extracts device ID from route parameters.
      *
@@ -11853,5 +11909,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.18", ngImpo
  * Generated bundle index. Do not edit.
  */
 
-export { AGGREGATIONS, AGGREGATION_ICONS, AGGREGATION_ICON_TYPE, AGGREGATION_LABELS, AGGREGATION_LIMITS, AGGREGATION_TEXTS, AGGREGATION_VALUES, AGGREGATION_VALUES_ARR, AggregationDisplayComponent, AggregationPickerComponent, AggregationPickerService, AggregationValidationService, AutoRefreshControlComponent, CONTEXT_FEATURE, CONTROL_PRESETS, ConfigContextSelectorComponent, ConfigModeControls, ConfigModeControls as ConfigModeControlsComponent, ConfigurationCollapseComponent, ConfigurationControlsComponent, ContextControlsComponent$1 as ContextControlsComponent, DEFAULT_WIDGET_TEMPLATE, DateContextQueryParamNames, DateTimeContextPickerComponent, DateTimeContextPickerService, GLOBAL_CONTEXT_DEFAULTS, GLOBAL_CONTEXT_DISPLAY_MODE, GLOBAL_CONTEXT_EVENTS, GLOBAL_CONTEXT_SOURCE, GlobalContextComponent, GlobalContextConfigComponent, GlobalContextConnectorComponent, GlobalContextEventService, GlobalContextFormService, GlobalContextInlineComponent, GlobalContextLinkControlsComponent, GlobalContextModule, GlobalContextNavigationService, GlobalContextQueryService, GlobalContextService, GlobalContextUtilsService, GlobalContextValidationService, GlobalContextWidgetConfigComponent, GlobalContextWidgetWrapperComponent, HistoryModeConfigurationControlsComponent, INTERVALS, INTERVAL_TITLES, IntervalPickerComponent, LINK_BTNS_CONFIG, LinkButtonsComponent, LiveModeConfigurationControlsComponent, LocalControlsComponent, PRESET_NAME, PreviewControlsComponent, REFRESH_OPTION, ROUTE_PATHS, RealtimeControlComponent, TIME_DURATION, TIME_INTERVAL, TIME_SPAN_MS, TIMING, TimeRangeDisplayComponent, UI_PRIORITIES, WIDGET_DISPLAY_MODE, WIDGET_FEATURE_MAP, WidgetConfigMigrationService, WidgetControlService, applyModeConstraints, buildAggregationExtensions, buildBaselineControls, buildWidgetControlsFromPresets, controlsToSettings, createAutoRefreshHandlers, createResult, defineWidgetControls, getSupportedModes, guards, isAggregationLinked, isAggregationUnlinked, isAutoRefreshDisabled, isAutoRefreshEnabled, isConfig, isDashboard, isDateTimeContextLinked, isDateTimeContextUnlinked, isHistory, isLive, isViewAndConfig, mergePartialControls, resolveWidgetControlsInput, setAutoRefreshControlsVisibility, setAutoRefreshLinks, updateBothSettings };
+export { AGGREGATIONS, AGGREGATION_ICONS, AGGREGATION_ICON_TYPE, AGGREGATION_LABELS, AGGREGATION_LIMITS, AGGREGATION_TEXTS, AGGREGATION_VALUES, AGGREGATION_VALUES_ARR, AggregationDisplayComponent, AggregationPickerComponent, AggregationPickerService, AggregationValidationService, AutoRefreshControlComponent, CONTEXT_FEATURE, CONTROL_PRESETS, ConfigContextSelectorComponent, ConfigModeControls, ConfigModeControls as ConfigModeControlsComponent, ConfigurationCollapseComponent, ConfigurationControlsComponent, ContextControlsComponent$1 as ContextControlsComponent, DEFAULT_WIDGET_TEMPLATE, DateContextQueryParamNames, DateTimeContextPickerComponent, DateTimeContextPickerService, GLOBAL_CONTEXT_DASHBOARD_PATHS, GLOBAL_CONTEXT_DEFAULTS, GLOBAL_CONTEXT_DISPLAY_MODE, GLOBAL_CONTEXT_EVENTS, GLOBAL_CONTEXT_SOURCE, GlobalContextComponent, GlobalContextConfigComponent, GlobalContextConnectorComponent, GlobalContextEventService, GlobalContextFormService, GlobalContextInlineComponent, GlobalContextLinkControlsComponent, GlobalContextModule, GlobalContextNavigationService, GlobalContextQueryService, GlobalContextService, GlobalContextUtilsService, GlobalContextValidationService, GlobalContextWidgetConfigComponent, GlobalContextWidgetWrapperComponent, HistoryModeConfigurationControlsComponent, INTERVALS, INTERVAL_TITLES, IntervalPickerComponent, LINK_BTNS_CONFIG, LinkButtonsComponent, LiveModeConfigurationControlsComponent, LocalControlsComponent, PRESET_NAME, PreviewControlsComponent, REFRESH_OPTION, ROUTE_PATHS, RealtimeControlComponent, TIME_DURATION, TIME_INTERVAL, TIME_SPAN_MS, TIMING, TimeRangeDisplayComponent, UI_PRIORITIES, WIDGET_DISPLAY_MODE, WIDGET_FEATURE_MAP, WidgetConfigMigrationService, WidgetControlService, applyModeConstraints, buildAggregationExtensions, buildBaselineControls, buildWidgetControlsFromPresets, controlsToSettings, createAutoRefreshHandlers, createResult, defineWidgetControls, getSupportedModes, guards, isAggregationLinked, isAggregationUnlinked, isAutoRefreshDisabled, isAutoRefreshEnabled, isConfig, isDashboard, isDateTimeContextLinked, isDateTimeContextUnlinked, isHistory, isLive, isViewAndConfig, mergePartialControls, resolveWidgetControlsInput, setAutoRefreshControlsVisibility, setAutoRefreshLinks, updateBothSettings };
 //# sourceMappingURL=c8y-ngx-components-global-context.mjs.map