phoenix-ui-components 3.0.6 → 4.0.0

package/dist/index.d.ts

@@ -1,31 +1,31 @@
 import * as i0 from '@angular/core';
-import { OnInit, EventEmitter, ElementRef, ChangeDetectorRef, OnDestroy, ComponentRef, AfterViewInit, QueryList, OnChanges, SimpleChanges, PipeTransform } from '@angular/core';
-import * as i66 from '@angular/material/checkbox';
+import { OnInit, EventEmitter, ElementRef, ChangeDetectorRef, NgZone, OnDestroy, ComponentRef, AfterViewInit, QueryList, OnChanges, SimpleChanges, PipeTransform } from '@angular/core';
+import * as i71 from '@angular/material/checkbox';
 import { MatCheckboxChange } from '@angular/material/checkbox';
 import * as phoenix_event_display from 'phoenix-event-display';
-import { PhoenixMenuNode, EventDisplay, AnimationPreset, PrettySymbols, ActiveVariable, PresetView, EventSummary } from 'phoenix-event-display';
-import * as i60 from '@angular/cdk/overlay';
+import { PhoenixMenuNode, EventDisplay, Configuration, AnimationPreset, PrettySymbols, ActiveVariable, PresetView, KinematicsConfig, MasterclassConfig, EventSummary, KinematicsColumn, TaggedParticle, ParticleTagDef } from 'phoenix-event-display';
+import * as i65 from '@angular/cdk/overlay';
 import { Overlay } from '@angular/cdk/overlay';
 import { Object3D, Object3DEventMap, Vector3 } from 'three';
-import * as i57 from '@angular/material/dialog';
+import * as i62 from '@angular/material/dialog';
 import { MatDialog, MatDialogRef } from '@angular/material/dialog';
 import { Subscription } from 'rxjs';
-import * as i62 from '@angular/material/menu';
+import * as i67 from '@angular/material/menu';
 import { MatMenuTrigger } from '@angular/material/menu';
-import * as i68 from '@angular/cdk/tree';
+import * as i73 from '@angular/cdk/tree';
 import { NestedTreeControl } from '@angular/cdk/tree';
 import { MatTreeNestedDataSource } from '@angular/material/tree';
-import * as i54 from '@angular/common';
-import * as i55 from '@angular/router';
-import * as i56 from '@angular/cdk/drag-drop';
-import * as i58 from '@angular/material/button';
-import * as i59 from '@angular/material/tooltip';
-import * as i61 from '@angular/forms';
-import * as i63 from '@angular/material/radio';
-import * as i64 from '@angular/material/slider';
-import * as i65 from '@angular/material/slide-toggle';
-import * as i67 from '@angular/material/icon';
-import * as i69 from '@angular/material/tabs';
+import * as i59 from '@angular/common';
+import * as i60 from '@angular/router';
+import * as i61 from '@angular/cdk/drag-drop';
+import * as i63 from '@angular/material/button';
+import * as i64 from '@angular/material/tooltip';
+import * as i66 from '@angular/forms';
+import * as i68 from '@angular/material/radio';
+import * as i69 from '@angular/material/slider';
+import * as i70 from '@angular/material/slide-toggle';
+import * as i72 from '@angular/material/icon';
+import * as i74 from '@angular/material/tabs';
 
 declare class NavComponent implements OnInit {
     constructor();
@@ -72,10 +72,26 @@ declare class PhoenixMenuComponent {
  * Service for all event display related functions.
  */
 declare class EventDisplayService extends EventDisplay {
+    private ngZone;
     /**
      * Instantiate the event display by calling the parent constructor.
      */
-    constructor();
+    constructor(ngZone: NgZone);
+    /**
+     * Initialize the event display, then move only the renderer's
+     * animation loop outside Angular's zone.
+     *
+     * `super.init()` runs inside the zone so that URL-option loading,
+     * event-change callbacks and other promise/fetch work still trigger
+     * Angular change detection as expected.
+     *
+     * Only the `requestAnimationFrame` loop (Three.js render + stats)
+     * is re-registered outside the zone, preventing ~60 unnecessary
+     * change-detection cycles per second.
+     *
+     * @param configuration Configuration used to customize different aspects.
+     */
+    init(configuration: Configuration): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EventDisplayService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<EventDisplayService>;
 }
@@ -715,6 +731,8 @@ interface UIMenuConfig {
     showInfoPanel?: boolean;
     showEventBrowser?: boolean;
     showEtaPhiPanel?: boolean;
+    showKinematicsPanel?: boolean;
+    showMasterclassPanel?: boolean;
 }
 declare const defaultUIMenuConfig: UIMenuConfig;
 declare class UiMenuComponent {
@@ -723,8 +741,10 @@ declare class UiMenuComponent {
         [key: string]: phoenix_event_display.AnimationPreset;
     };
     uiConfig: UIMenuConfig;
+    kinematicsConfig?: KinematicsConfig;
+    masterclassConfig?: MasterclassConfig;
     static ɵfac: i0.ɵɵFactoryDeclaration<UiMenuComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<UiMenuComponent, "app-ui-menu", never, { "eventDataImportOptions": { "alias": "eventDataImportOptions"; "required": false; }; "animationPresets": { "alias": "animationPresets"; "required": false; }; "uiConfig": { "alias": "uiConfig"; "required": false; }; }, {}, never, ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UiMenuComponent, "app-ui-menu", never, { "eventDataImportOptions": { "alias": "eventDataImportOptions"; "required": false; }; "animationPresets": { "alias": "animationPresets"; "required": false; }; "uiConfig": { "alias": "uiConfig"; "required": false; }; "kinematicsConfig": { "alias": "kinematicsConfig"; "required": false; }; "masterclassConfig": { "alias": "masterclassConfig"; "required": false; }; }, {}, never, ["*"], false, never>;
 }
 
 declare class ShareLinkComponent {
@@ -816,10 +836,10 @@ declare class FileLoaderService {
     private lastEventsURL;
     private lastEventsOptions;
     unzip(data: ArrayBuffer): Promise<string>;
-    makeRequest(urlPath: string, responseType: 'json' | 'text' | 'blob', onData: (data: any) => void, options?: any): boolean;
+    makeRequest(urlPath: string, responseType: 'json' | 'text' | 'blob', onData: (data: any) => void, options?: any): Promise<boolean>;
     loadJSONEvent(eventData: string, eventDisplay: EventDisplayService): void;
     loadJiveXMLEvent(eventData: string, eventDisplay: EventDisplayService): void;
-    loadEvent(file: string, eventDisplay: EventDisplayService, options?: any): boolean;
+    loadEvent(file: string, eventDisplay: EventDisplayService, options?: any): Promise<boolean>;
     reloadLastEvents(eventDisplay: EventDisplayService): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<FileLoaderService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<FileLoaderService>;
@@ -840,8 +860,8 @@ declare class EventDataExplorerDialogComponent {
     loading: boolean;
     error: boolean;
     constructor(eventDisplay: EventDisplayService, fileLoader: FileLoaderService, dialogRef: MatDialogRef<EventDataExplorerDialogComponent>, dialogData: EventDataExplorerDialogData);
-    loadEvent(file: FileEvent): void;
-    loadConfig(file: FileEvent): void;
+    loadEvent(file: FileEvent): Promise<void>;
+    loadConfig(file: FileEvent): Promise<void>;
     onClose(): void;
     private buildFileNode;
     static ɵfac: i0.ɵɵFactoryDeclaration<EventDataExplorerDialogComponent, never>;
@@ -1032,12 +1052,186 @@ declare class EtaPhiPanelComponent implements OnInit, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<EtaPhiPanelComponent, "app-eta-phi-panel", never, {}, {}, never, never, false, never>;
 }
 
+/** Pre-computed row for display. */
+interface KinematicsRow {
+    uuid: string;
+    values: {
+        [columnId: string]: number | string;
+    };
+    isCut: boolean;
+}
+declare class KinematicsPanelOverlayComponent implements OnInit, OnDestroy {
+    private eventDisplay;
+    private cdr;
+    /** Visibility toggle — refreshes data when panel becomes visible. */
+    private _showKinematics;
+    set showKinematics(val: boolean);
+    get showKinematics(): boolean;
+    config: KinematicsConfig;
+    /** Available collections matching the configured type. */
+    collections: string[];
+    /** Currently selected collection name. */
+    selectedCollection: string;
+    /** All rows before filtering. */
+    allRows: KinematicsRow[];
+    /** Filtered display rows. */
+    rows: KinematicsRow[];
+    /** Current sort state. */
+    sortColumn: string;
+    sortDirection: 'asc' | 'desc';
+    /** Tracks the 3D-selected object for bidirectional highlighting. */
+    activeObject: ActiveVariable<string>;
+    /** Resolved group uuid for the currently active 3D object. */
+    activeRowUuid: string;
+    /** Filter threshold value (for pT cut etc.). */
+    filterValue: number;
+    /** Resolved filter column definition. */
+    filterCol: KinematicsColumn | undefined;
+    private unsubscribes;
+    constructor(eventDisplay: EventDisplayService, cdr: ChangeDetectorRef);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    /** Reload collections and recompute rows. */
+    refreshData(): void;
+    /** Load and compute rows for a collection. */
+    selectCollection(name: string): void;
+    /** Toggle sort on a column. */
+    sort(columnId: string): void;
+    /** Update the filter threshold and refilter. */
+    onFilterChange(value: string): void;
+    /** Apply filter then sort. */
+    private applyFilterAndSort;
+    /** Highlight a track in 3D and update active object. */
+    selectTrack(row: KinematicsRow): void;
+    /** Pan camera to a track and highlight it. */
+    lookAtTrack(uuid: string, event: Event): void;
+    /** Keyboard navigation: arrow keys move between rows, Enter looks at track. */
+    onKeyDown(event: KeyboardEvent): void;
+    /** Export displayed rows as TSV. */
+    exportTSV(): void;
+    /** Format a value for display. */
+    formatValue(value: number | string, col: KinematicsColumn): string;
+    /** Get the charge sign class for colored +/- display. */
+    getChargeClass(col: KinematicsColumn, value: number | string): string;
+    /** Charge-based color for the row index number. */
+    getChargeColor(row: KinematicsRow): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<KinematicsPanelOverlayComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<KinematicsPanelOverlayComponent, "app-kinematics-panel-overlay", never, { "showKinematics": { "alias": "showKinematics"; "required": false; }; "config": { "alias": "config"; "required": false; }; }, {}, never, never, false, never>;
+}
+
+declare class KinematicsPanelComponent implements OnInit, OnDestroy, OnChanges {
+    private overlay;
+    showKinematics: boolean;
+    overlayWindow: ComponentRef<KinematicsPanelOverlayComponent>;
+    config?: KinematicsConfig;
+    constructor(overlay: Overlay);
+    ngOnInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    toggleOverlay(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<KinematicsPanelComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<KinematicsPanelComponent, "app-kinematics-panel", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, false, never>;
+}
+
+declare class MoreInfoComponent {
+    uiConfig: UIMenuConfig;
+    kinematicsConfig?: KinematicsConfig;
+    infoPanel: InfoPanelComponent;
+    eventBrowser: EventBrowserComponent;
+    collectionsInfo: CollectionsInfoComponent;
+    etaPhiPanel: EtaPhiPanelComponent;
+    geometryBrowser: GeometryBrowserComponent;
+    kinematicsPanel: KinematicsPanelComponent;
+    showInfoPanel: boolean;
+    showEventBrowser: boolean;
+    showCollectionsInfo: boolean;
+    showEtaPhiPanel: boolean;
+    showGeometryBrowser: boolean;
+    showKinematicsPanel: boolean;
+    toggleInfoPanel(): void;
+    toggleEventBrowser(): void;
+    toggleCollectionsInfo(): void;
+    toggleEtaPhiPanel(): void;
+    toggleGeometryBrowser(): void;
+    toggleKinematicsPanel(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MoreInfoComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MoreInfoComponent, "app-more-info", never, { "uiConfig": { "alias": "uiConfig"; "required": false; }; "kinematicsConfig": { "alias": "kinematicsConfig"; "required": false; }; }, {}, never, never, false, never>;
+}
+
 declare class UiMenuWrapperComponent {
     hideUIMenu: boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<UiMenuWrapperComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<UiMenuWrapperComponent, "app-ui-menu-wrapper", never, {}, {}, never, ["*"], false, never>;
 }
 
+interface MassResult {
+    eventType: string;
+    mass: number;
+    particleCount: number;
+}
+interface CollectionItem {
+    index: number;
+    uuid: string;
+    userData: any;
+    selected: boolean;
+    pT: number;
+    eta: number;
+    phi: number;
+}
+declare class MasterclassPanelOverlayComponent implements OnInit, OnDestroy {
+    private eventDisplay;
+    showPanel: boolean;
+    config: MasterclassConfig;
+    collectionNames: string[];
+    selectedCollection: string;
+    collectionItems: CollectionItem[];
+    taggedParticles: TaggedParticle[];
+    massResults: MassResult[];
+    statusMessage: string;
+    statusType: 'info' | 'success' | 'warning';
+    /** Live invariant mass of currently tagged particles. */
+    get liveMass(): number;
+    /** Live event type classification using experiment-specific classifier. */
+    get liveEventType(): string;
+    get selectedCount(): number;
+    private unsubscribes;
+    constructor(eventDisplay: EventDisplayService);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    private loadCollections;
+    selectCollection(name: string): void;
+    toggleItem(item: CollectionItem): void;
+    highlightItem(uuid: string): void;
+    tagSelectedAs(tagDef: ParticleTagDef): void;
+    removeTagged(index: number): void;
+    clearTagged(): void;
+    recordResult(): void;
+    removeResult(index: number): void;
+    clearResults(): void;
+    exportResults(): void;
+    massGeV(mev: number): string;
+    ptGeV(mev: number): string;
+    /** Look up the tag definition for a tagged particle. */
+    getTagDef(tagId: string): ParticleTagDef | undefined;
+    private setStatus;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MasterclassPanelOverlayComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MasterclassPanelOverlayComponent, "app-masterclass-panel-overlay", never, { "showPanel": { "alias": "showPanel"; "required": false; }; "config": { "alias": "config"; "required": false; }; }, {}, never, never, false, never>;
+}
+
+declare class MasterclassPanelComponent implements OnInit, OnDestroy, OnChanges {
+    private overlay;
+    config?: MasterclassConfig;
+    showPanel: boolean;
+    overlayWindow: ComponentRef<MasterclassPanelOverlayComponent>;
+    constructor(overlay: Overlay);
+    ngOnInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    toggleOverlay(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MasterclassPanelComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MasterclassPanelComponent, "app-masterclass-panel", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, false, never>;
+}
+
 declare class ErrorMessageService {
     /** A variable that stores the latest error thrown. */
     private error;
@@ -1103,9 +1297,76 @@ declare class AttributePipe implements PipeTransform {
 
 declare class PhoenixUIModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PhoenixUIModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<PhoenixUIModule, [typeof NavComponent, typeof UiMenuWrapperComponent, typeof UiMenuComponent, typeof CollectionsInfoComponent, typeof GeometryBrowserComponent, typeof GeometryBrowserOverlayComponent, typeof MenuToggleComponent, typeof CollectionsInfoOverlayComponent, typeof IoOptionsComponent, typeof IOOptionsDialogComponent, typeof OverlayViewComponent, typeof ObjectSelectionComponent, typeof ObjectSelectionOverlayComponent, typeof EventSelectorComponent, typeof ObjectClippingComponent, typeof DarkThemeComponent, typeof AutoRotateComponent, typeof ViewOptionsComponent, typeof CartesianGridConfigComponent, typeof OverlayViewWindowComponent, typeof OverlayComponent, typeof ExperimentInfoComponent, typeof InfoPanelComponent, typeof InfoPanelOverlayComponent, typeof MainViewToggleComponent, typeof ZoomControlsComponent, typeof TreeMenuComponent, typeof TreeMenuItemComponent, typeof PhoenixMenuComponent, typeof PhoenixMenuItemComponent, typeof ConfigSliderComponent, typeof AnimateCameraComponent, typeof AnimateEventComponent, typeof VrToggleComponent, typeof ArToggleComponent, typeof SSModeComponent, typeof MakePictureComponent, typeof PerformanceToggleComponent, typeof LoaderComponent, typeof ShareLinkComponent, typeof ShareLinkDialogComponent, typeof EmbedMenuComponent, typeof ExperimentLinkComponent, typeof EventDataExplorerComponent, typeof EventDataExplorerDialogComponent, typeof FileExplorerComponent, typeof RingLoaderComponent, typeof CycleEventsComponent, typeof EventBrowserComponent, typeof EventBrowserOverlayComponent, typeof EtaPhiPanelComponent, typeof EtaPhiPanelOverlayComponent], [typeof AttributePipe, typeof i54.CommonModule, typeof i55.RouterModule, typeof i56.DragDropModule, typeof i57.MatDialogModule, typeof i58.MatButtonModule, typeof i59.MatTooltipModule, typeof i60.OverlayModule, typeof i61.FormsModule, typeof i61.ReactiveFormsModule, typeof i62.MatMenuModule, typeof i63.MatRadioModule, typeof i64.MatSliderModule, typeof i65.MatSlideToggleModule, typeof i66.MatCheckboxModule, typeof i67.MatIconModule, typeof i68.CdkTreeModule, typeof i69.MatTabsModule], [typeof NavComponent, typeof UiMenuWrapperComponent, typeof UiMenuComponent, typeof CollectionsInfoComponent, typeof GeometryBrowserComponent, typeof GeometryBrowserOverlayComponent, typeof MenuToggleComponent, typeof CollectionsInfoOverlayComponent, typeof IoOptionsComponent, typeof IOOptionsDialogComponent, typeof OverlayViewComponent, typeof ObjectSelectionComponent, typeof ObjectSelectionOverlayComponent, typeof EventSelectorComponent, typeof ObjectClippingComponent, typeof DarkThemeComponent, typeof AutoRotateComponent, typeof ViewOptionsComponent, typeof CartesianGridConfigComponent, typeof OverlayViewWindowComponent, typeof OverlayComponent, typeof ExperimentInfoComponent, typeof InfoPanelComponent, typeof InfoPanelOverlayComponent, typeof MainViewToggleComponent, typeof ZoomControlsComponent, typeof TreeMenuComponent, typeof TreeMenuItemComponent, typeof PhoenixMenuComponent, typeof PhoenixMenuItemComponent, typeof ConfigSliderComponent, typeof AnimateCameraComponent, typeof AnimateEventComponent, typeof VrToggleComponent, typeof ArToggleComponent, typeof SSModeComponent, typeof MakePictureComponent, typeof PerformanceToggleComponent, typeof LoaderComponent, typeof ShareLinkComponent, typeof ShareLinkDialogComponent, typeof EmbedMenuComponent, typeof ExperimentLinkComponent, typeof EventDataExplorerComponent, typeof EventDataExplorerDialogComponent, typeof FileExplorerComponent, typeof RingLoaderComponent, typeof CycleEventsComponent, typeof EventBrowserComponent, typeof EventBrowserOverlayComponent, typeof EtaPhiPanelComponent, typeof EtaPhiPanelOverlayComponent, typeof AttributePipe]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<PhoenixUIModule, [typeof NavComponent, typeof UiMenuWrapperComponent, typeof UiMenuComponent, typeof MoreInfoComponent, typeof CollectionsInfoComponent, typeof GeometryBrowserComponent, typeof GeometryBrowserOverlayComponent, typeof MenuToggleComponent, typeof CollectionsInfoOverlayComponent, typeof IoOptionsComponent, typeof IOOptionsDialogComponent, typeof OverlayViewComponent, typeof ObjectSelectionComponent, typeof ObjectSelectionOverlayComponent, typeof EventSelectorComponent, typeof ObjectClippingComponent, typeof DarkThemeComponent, typeof AutoRotateComponent, typeof ViewOptionsComponent, typeof CartesianGridConfigComponent, typeof OverlayViewWindowComponent, typeof OverlayComponent, typeof ExperimentInfoComponent, typeof InfoPanelComponent, typeof InfoPanelOverlayComponent, typeof MainViewToggleComponent, typeof ZoomControlsComponent, typeof TreeMenuComponent, typeof TreeMenuItemComponent, typeof PhoenixMenuComponent, typeof PhoenixMenuItemComponent, typeof ConfigSliderComponent, typeof AnimateCameraComponent, typeof AnimateEventComponent, typeof VrToggleComponent, typeof ArToggleComponent, typeof SSModeComponent, typeof MakePictureComponent, typeof PerformanceToggleComponent, typeof LoaderComponent, typeof ShareLinkComponent, typeof ShareLinkDialogComponent, typeof EmbedMenuComponent, typeof ExperimentLinkComponent, typeof EventDataExplorerComponent, typeof EventDataExplorerDialogComponent, typeof FileExplorerComponent, typeof RingLoaderComponent, typeof CycleEventsComponent, typeof EventBrowserComponent, typeof EventBrowserOverlayComponent, typeof EtaPhiPanelComponent, typeof EtaPhiPanelOverlayComponent, typeof KinematicsPanelComponent, typeof KinematicsPanelOverlayComponent, typeof MasterclassPanelComponent, typeof MasterclassPanelOverlayComponent], [typeof AttributePipe, typeof i59.CommonModule, typeof i60.RouterModule, typeof i61.DragDropModule, typeof i62.MatDialogModule, typeof i63.MatButtonModule, typeof i64.MatTooltipModule, typeof i65.OverlayModule, typeof i66.FormsModule, typeof i66.ReactiveFormsModule, typeof i67.MatMenuModule, typeof i68.MatRadioModule, typeof i69.MatSliderModule, typeof i70.MatSlideToggleModule, typeof i71.MatCheckboxModule, typeof i72.MatIconModule, typeof i73.CdkTreeModule, typeof i74.MatTabsModule], [typeof NavComponent, typeof UiMenuWrapperComponent, typeof UiMenuComponent, typeof MoreInfoComponent, typeof CollectionsInfoComponent, typeof GeometryBrowserComponent, typeof GeometryBrowserOverlayComponent, typeof MenuToggleComponent, typeof CollectionsInfoOverlayComponent, typeof IoOptionsComponent, typeof IOOptionsDialogComponent, typeof OverlayViewComponent, typeof ObjectSelectionComponent, typeof ObjectSelectionOverlayComponent, typeof EventSelectorComponent, typeof ObjectClippingComponent, typeof DarkThemeComponent, typeof AutoRotateComponent, typeof ViewOptionsComponent, typeof CartesianGridConfigComponent, typeof OverlayViewWindowComponent, typeof OverlayComponent, typeof ExperimentInfoComponent, typeof InfoPanelComponent, typeof InfoPanelOverlayComponent, typeof MainViewToggleComponent, typeof ZoomControlsComponent, typeof TreeMenuComponent, typeof TreeMenuItemComponent, typeof PhoenixMenuComponent, typeof PhoenixMenuItemComponent, typeof ConfigSliderComponent, typeof AnimateCameraComponent, typeof AnimateEventComponent, typeof VrToggleComponent, typeof ArToggleComponent, typeof SSModeComponent, typeof MakePictureComponent, typeof PerformanceToggleComponent, typeof LoaderComponent, typeof ShareLinkComponent, typeof ShareLinkDialogComponent, typeof EmbedMenuComponent, typeof ExperimentLinkComponent, typeof EventDataExplorerComponent, typeof EventDataExplorerDialogComponent, typeof FileExplorerComponent, typeof RingLoaderComponent, typeof CycleEventsComponent, typeof EventBrowserComponent, typeof EventBrowserOverlayComponent, typeof EtaPhiPanelComponent, typeof EtaPhiPanelOverlayComponent, typeof KinematicsPanelComponent, typeof KinematicsPanelOverlayComponent, typeof MasterclassPanelComponent, typeof MasterclassPanelOverlayComponent, typeof AttributePipe]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<PhoenixUIModule>;
 }
 
-export { AnimateCameraComponent, AnimateEventComponent, ArToggleComponent, AttributePipe, AutoRotateComponent, CartesianGridConfigComponent, CollectionsInfoComponent, CollectionsInfoOverlayComponent, ConfigSliderComponent, CycleEventsComponent, DarkThemeComponent, EmbedMenuComponent, EtaPhiPanelComponent, EtaPhiPanelOverlayComponent, EventBrowserComponent, EventBrowserOverlayComponent, EventDataExplorerComponent, EventDataExplorerDialogComponent, EventDataFormat, EventDisplayService, EventSelectorComponent, ExperimentInfoComponent, ExperimentLinkComponent, FileEvent, FileExplorerComponent, FileNode, GeometryBrowserComponent, GeometryBrowserOverlayComponent, IOOptionsDialogComponent, ImportOption, InfoPanelComponent, InfoPanelOverlayComponent, IoOptionsComponent, LoaderComponent, MainViewToggleComponent, MakePictureComponent, MenuToggleComponent, NavComponent, ObjectClippingComponent, ObjectSelectionComponent, ObjectSelectionOverlayComponent, OverlayComponent, OverlayViewComponent, OverlayViewWindowComponent, PerformanceToggleComponent, PhoenixMenuComponent, PhoenixMenuItemComponent, PhoenixUIModule, RingLoaderComponent, SSModeComponent, ShareLinkComponent, ShareLinkDialogComponent, TreeMenuComponent, TreeMenuItemComponent, UiMenuComponent, UiMenuWrapperComponent, ViewOptionsComponent, VrToggleComponent, ZoomControlsComponent, defaultAnimationPresets, defaultUIMenuConfig };
-export type { EventDataExplorerDialogData, EventDataImportOption, FileResponse, TreeMenuNode, UIMenuConfig };
+/** Severity levels for notifications. */
+type NotificationSeverity = 'success' | 'info' | 'warning' | 'error';
+/** A notification message with severity and content. */
+interface Notification {
+    /** The message to display to the user. */
+    message: string;
+    /** The severity level of the notification. */
+    severity: NotificationSeverity;
+    /** Duration in milliseconds before auto-dismiss. 0 means no auto-dismiss. */
+    duration: number;
+}
+/**
+ * Service for displaying user-facing notifications with severity levels.
+ * Provides success, info, warning, and error notifications with
+ * configurable auto-dismiss durations. Replaces silent console errors
+ * with actionable user feedback across all Phoenix components.
+ */
+declare class NotificationService {
+    /** Default auto-dismiss durations in milliseconds per severity level. */
+    private readonly defaultDurations;
+    /** Active variable that stores the latest notification. */
+    private notification;
+    /**
+     * Subscribe to incoming notifications.
+     * @param callback Function called when a notification is emitted.
+     * @returns A function that can be called to unsubscribe.
+     */
+    subscribeToNotifications(callback: (notification: Notification) => void): () => void;
+    /**
+     * Display a success notification.
+     * Auto-dismisses after 5 seconds by default.
+     * @param message The message to display.
+     * @param duration Optional custom duration in ms. 0 means no auto-dismiss.
+     */
+    success(message: string, duration?: number): void;
+    /**
+     * Display an info notification.
+     * Auto-dismisses after 5 seconds by default.
+     * @param message The message to display.
+     * @param duration Optional custom duration in ms. 0 means no auto-dismiss.
+     */
+    info(message: string, duration?: number): void;
+    /**
+     * Display a warning notification.
+     * Auto-dismisses after 8 seconds by default.
+     * @param message The message to display.
+     * @param duration Optional custom duration in ms. 0 means no auto-dismiss.
+     */
+    warning(message: string, duration?: number): void;
+    /**
+     * Display an error notification.
+     * Does not auto-dismiss by default — requires manual dismissal.
+     * @param message The message to display.
+     * @param duration Optional custom duration in ms. 0 means no auto-dismiss.
+     */
+    error(message: string, duration?: number): void;
+    /**
+     * Internal method to emit a notification.
+     * @param message The message to display.
+     * @param severity The severity level.
+     * @param duration Optional custom duration override.
+     */
+    private notify;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NotificationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<NotificationService>;
+}
+
+export { AnimateCameraComponent, AnimateEventComponent, ArToggleComponent, AttributePipe, AutoRotateComponent, CartesianGridConfigComponent, CollectionsInfoComponent, CollectionsInfoOverlayComponent, ConfigSliderComponent, CycleEventsComponent, DarkThemeComponent, EmbedMenuComponent, EtaPhiPanelComponent, EtaPhiPanelOverlayComponent, EventBrowserComponent, EventBrowserOverlayComponent, EventDataExplorerComponent, EventDataExplorerDialogComponent, EventDataFormat, EventDisplayService, EventSelectorComponent, ExperimentInfoComponent, ExperimentLinkComponent, FileEvent, FileExplorerComponent, FileNode, GeometryBrowserComponent, GeometryBrowserOverlayComponent, IOOptionsDialogComponent, ImportOption, InfoPanelComponent, InfoPanelOverlayComponent, IoOptionsComponent, KinematicsPanelComponent, KinematicsPanelOverlayComponent, LoaderComponent, MainViewToggleComponent, MakePictureComponent, MasterclassPanelComponent, MasterclassPanelOverlayComponent, MenuToggleComponent, MoreInfoComponent, NavComponent, NotificationService, ObjectClippingComponent, ObjectSelectionComponent, ObjectSelectionOverlayComponent, OverlayComponent, OverlayViewComponent, OverlayViewWindowComponent, PerformanceToggleComponent, PhoenixMenuComponent, PhoenixMenuItemComponent, PhoenixUIModule, RingLoaderComponent, SSModeComponent, ShareLinkComponent, ShareLinkDialogComponent, TreeMenuComponent, TreeMenuItemComponent, UiMenuComponent, UiMenuWrapperComponent, ViewOptionsComponent, VrToggleComponent, ZoomControlsComponent, defaultAnimationPresets, defaultUIMenuConfig };
+export type { EventDataExplorerDialogData, EventDataImportOption, FileResponse, Notification, NotificationSeverity, TreeMenuNode, UIMenuConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phoenix-ui-components",
-  "version": "3.0.6",
+  "version": "4.0.0",
   "description": "Reusable Angular components of the Phoenix event display application.",
   "author": "Phoenix contributors (https://github.com/HSF/phoenix/graphs/contributors)",
   "license": "Apache-2.0",
@@ -25,11 +25,11 @@
     "zone.js": "*"
   },
   "dependencies": {
-    "@angular/animations": "^20.3.16",
+    "@angular/animations": "^20.3.23",
     "@angular/cdk": "^20.2.14",
-    "@angular/forms": "^20.3.16",
+    "@angular/forms": "^20.3.23",
     "@angular/material": "^20.2.14",
-    "@angular/platform-browser": "^20.3.16",
+    "@angular/platform-browser": "^20.3.23",
     "css-element-queries": "^1.2.3",
     "qrcode": "1.5.4",
     "rxjs": "^7.8.2",
@@ -48,5 +48,5 @@
       "sass": "./_theming.scss"
     }
   },
-  "gitHead": "da086082d26c1f972e8a645d3e3dc2c251c56186"
+  "gitHead": "e6246f6406e8b24af9a5a47c5113d52a614211d7"
 }