phoenix-ui-components 4.0.1 → 4.2.0

package/dist/index.d.ts

@@ -1,31 +1,34 @@
 import * as i0 from '@angular/core';
-import { OnInit, EventEmitter, ElementRef, ChangeDetectorRef, NgZone, OnDestroy, ComponentRef, AfterViewInit, QueryList, OnChanges, SimpleChanges, PipeTransform } from '@angular/core';
-import * as i71 from '@angular/material/checkbox';
+import { OnInit, EventEmitter, ElementRef, ChangeDetectorRef, OnDestroy, NgZone, ComponentRef, AfterViewInit, QueryList, OnChanges, SimpleChanges, PipeTransform } from '@angular/core';
+import * as i76 from '@angular/material/checkbox';
 import { MatCheckboxChange } from '@angular/material/checkbox';
 import * as phoenix_event_display from 'phoenix-event-display';
-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 i62 from '@angular/material/dialog';
+import { PhoenixMenuNode, EventDisplay, Configuration, AnimationPreset, PrettySymbols, ActiveVariable, PresetView, KinematicsConfig, MasterclassConfig, EventSummary, KinematicsColumn, TaggedParticle, ParticleTagDef, SessionState } from 'phoenix-event-display';
+import * as i67 from '@angular/material/dialog';
 import { MatDialog, MatDialogRef } from '@angular/material/dialog';
-import { Subscription } from 'rxjs';
-import * as i67 from '@angular/material/menu';
+import * as i62 from '@angular/material/snack-bar';
+import { MatSnackBar } from '@angular/material/snack-bar';
+import { Observable, Subscription } from 'rxjs';
+import * as i70 from '@angular/cdk/overlay';
+import { Overlay, GlobalPositionStrategy } from '@angular/cdk/overlay';
+import { Object3D, Object3DEventMap, Vector3 } from 'three';
+import * as i72 from '@angular/material/menu';
 import { MatMenuTrigger } from '@angular/material/menu';
-import * as i73 from '@angular/cdk/tree';
+import * as i78 from '@angular/cdk/tree';
 import { NestedTreeControl } from '@angular/cdk/tree';
 import { MatTreeNestedDataSource } from '@angular/material/tree';
-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';
+import * as i64 from '@angular/common';
+import * as i65 from '@angular/router';
+import * as i66 from '@angular/cdk/drag-drop';
+import * as i68 from '@angular/material/button';
+import * as i69 from '@angular/material/tooltip';
+import * as i71 from '@angular/forms';
+import * as i73 from '@angular/material/radio';
+import * as i74 from '@angular/material/slider';
+import * as i75 from '@angular/material/slide-toggle';
+import * as i77 from '@angular/material/icon';
+import * as i79 from '@angular/material/tabs';
+import * as i80 from '@angular/material/progress-bar';
 
 declare class NavComponent implements OnInit {
     constructor();
@@ -56,6 +59,17 @@ declare class PhoenixMenuItemComponent {
     phoenixMenuItem: ElementRef<HTMLDivElement>;
     configTop: number;
     constructor(cdr: ChangeDetectorRef);
+    /**
+     * Whether a node is a leaf holding only configs (like the collections'
+     * "Draw/Cut/Color Options"), which is displayed as a compact icon button
+     * in a toolbar instead of a full menu row.
+     */
+    isCompactOptionsNode(node: PhoenixMenuNode): boolean;
+    get isCompact(): boolean;
+    /** Label for the compact icon button, e.g. "Draw Options" -> "Draw". */
+    get compactLabel(): string;
+    get compactChildren(): PhoenixMenuNode[];
+    get regularChildren(): PhoenixMenuNode[];
     calculateConfigTop(): void;
     castConfigsToAny(configs: PhoenixMenuNode['configs']): any[];
     static ɵfac: i0.ɵɵFactoryDeclaration<PhoenixMenuItemComponent, never>;
@@ -63,11 +77,110 @@ declare class PhoenixMenuItemComponent {
 }
 
 declare class PhoenixMenuComponent {
+    private dialog;
     rootNode: PhoenixMenuNode;
+    constructor(dialog: MatDialog);
+    openShortcutsDialog(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PhoenixMenuComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PhoenixMenuComponent, "app-phoenix-menu", never, { "rootNode": { "alias": "rootNode"; "required": false; }; }, {}, never, never, false, never>;
 }
 
+declare class ShortcutsDialogComponent {
+    dialogRef: MatDialogRef<ShortcutsDialogComponent>;
+    constructor(dialogRef: MatDialogRef<ShortcutsDialogComponent>);
+    onClose(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ShortcutsDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ShortcutsDialogComponent, "app-shortcuts-dialog", never, {}, {}, never, never, false, never>;
+}
+
+/** 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>;
+}
+
+/**
+ * Component that subscribes to NotificationService and displays
+ * transient toast notifications via MatSnackBar.
+ *
+ * Severity levels map to CSS panel classes:
+ * - success → notification-success
+ * - info    → notification-info
+ * - warning → notification-warning
+ * - error   → notification-error
+ */
+declare class NotificationToastComponent implements OnInit, OnDestroy {
+    private notificationService;
+    private snackBar;
+    private unsubscribe;
+    constructor(notificationService: NotificationService, snackBar: MatSnackBar);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NotificationToastComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NotificationToastComponent, "app-notification-toast", never, {}, {}, never, never, false, never>;
+}
+
 /**
  * Service for all event display related functions.
  */
@@ -101,19 +214,47 @@ declare const defaultAnimationPresets: {
 };
 declare class AnimateCameraComponent {
     private eventDisplay;
+    private dialog;
     animationPresets: {
         [key: string]: AnimationPreset;
     };
     animationPresetsKeys: string[];
     isAnimating: boolean;
-    constructor(eventDisplay: EventDisplayService);
-    animatePreset(preset: string): void;
-    animateCamera(): void;
+    constructor(eventDisplay: EventDisplayService, dialog: MatDialog);
+    playPreset(preset: string): void;
+    playAnimateCamera(): void;
+    downloadAnimation(preset?: string): void;
+    /**
+     * Animate through the given preset.
+     * @returns Whether the animation was started.
+     */
+    animatePreset(preset: string, onEnd?: () => void): boolean;
+    /**
+     * Animate the camera through the event.
+     * @returns Whether the animation was started. It is refused while another
+     * animation is already running.
+     */
+    animateCamera(onEnd?: () => void): boolean;
     private setDetectorOpacity;
     static ɵfac: i0.ɵɵFactoryDeclaration<AnimateCameraComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<AnimateCameraComponent, "app-animate-camera", never, { "animationPresets": { "alias": "animationPresets"; "required": false; }; }, {}, never, never, false, never>;
 }
 
+declare class DownloadAnimationDialogComponent implements OnInit, OnDestroy {
+    data: {
+        progress$: Observable<number>;
+    };
+    progress: number;
+    private progressSub?;
+    constructor(data: {
+        progress$: Observable<number>;
+    });
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DownloadAnimationDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DownloadAnimationDialogComponent, "app-download-animation-dialog", never, {}, {}, never, never, false, never>;
+}
+
 declare class AnimateEventComponent {
     private eventDisplay;
     isAnimating: boolean;
@@ -164,6 +305,7 @@ declare class CollectionsInfoOverlayComponent implements OnInit, OnDestroy {
     enableHighlighting(): void;
     disableHighlighting(): void;
     toggleInvisible(checked: boolean): void;
+    formatValue(value: any): string;
     addLabel(index: number, uuid: string): void;
     private getEventDataGroup;
     static ɵfac: i0.ɵɵFactoryDeclaration<CollectionsInfoOverlayComponent, never>;
@@ -276,11 +418,24 @@ declare class InfoPanelOverlayComponent implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<InfoPanelOverlayComponent, "app-info-panel-overlay", never, { "showInfoPanel": { "alias": "showInfoPanel"; "required": false; }; }, {}, never, never, false, never>;
 }
 
+declare class OverlayCascadeService {
+    private overlay;
+    private cascadeCount;
+    private topOffset;
+    private leftOffset;
+    private step;
+    constructor(overlay: Overlay);
+    getCascadePositionStrategy(): GlobalPositionStrategy;
+    static ɵfac: i0.ɵɵFactoryDeclaration<OverlayCascadeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<OverlayCascadeService>;
+}
+
 /**
  * Component for toggling info panel overlay
  */
 declare class InfoPanelComponent implements OnInit, OnDestroy {
     private overlay;
+    private overlayCascade;
     /** @ignore */
     showInfoPanel: boolean;
     /** Information panel overlay window */
@@ -289,7 +444,7 @@ declare class InfoPanelComponent implements OnInit, OnDestroy {
      * Create the info panel toggle
      * @param overlay Info panel overlay containing logger data
      */
-    constructor(overlay: Overlay);
+    constructor(overlay: Overlay, overlayCascade: OverlayCascadeService);
     /**
      * Create the info panel overlay
      */
@@ -311,6 +466,7 @@ declare enum EventDataFormat {
     EDM4HEPJSON = "EDM4HEPJSON",
     JIVEXML = "JIVEXML",
     PHYSLITE = "PHYSLITE",
+    ATLASESD = "ATLASESD",
     IG = "IG",
     ZIP = "ZIP"
 }
@@ -335,10 +491,11 @@ declare class IoOptionsComponent {
 declare class IOOptionsDialogComponent implements OnInit {
     private eventDisplay;
     dialogRef: MatDialogRef<IOOptionsDialogComponent>;
+    private notificationService;
     eventDataImportOptions: EventDataImportOption[];
     eventDataOptionsWithHandler: ImportOption[];
     private supportedEventDataFormats;
-    constructor(eventDisplay: EventDisplayService, dialogRef: MatDialogRef<IOOptionsDialogComponent>);
+    constructor(eventDisplay: EventDisplayService, dialogRef: MatDialogRef<IOOptionsDialogComponent>, notificationService: NotificationService);
     ngOnInit(): void;
     getSupportedEventDataFormats(): string;
     onClose(): void;
@@ -353,6 +510,7 @@ declare class IOOptionsDialogComponent implements OnInit {
     handleROOTInput(files: FileList): Promise<void>;
     handleRootJSONInput(files: FileList): Promise<void>;
     handlePHYSLITEInput(files: FileList): Promise<void>;
+    handleATLASESDInput(files: FileList): Promise<void>;
     handleIgEventDataInput(files: FileList): void;
     handleZipEventDataInput(files: FileList): Promise<void>;
     handleFileInput(file: File, extensions: string, callback: (result: string, fileName?: string) => void): void;
@@ -426,12 +584,15 @@ declare class ObjectSelectionComponent implements OnInit, OnDestroy {
 /**
  * Component for overlay panel.
  */
-declare class OverlayComponent implements AfterViewInit, OnDestroy {
+declare class OverlayComponent implements OnInit, AfterViewInit, OnDestroy {
     private eventDisplay;
+    private elementRef;
     /** Title of the overlay. */
     overlayTitle: string;
     /** If the overlay is open or not. */
-    active: boolean;
+    private _active;
+    set active(value: boolean);
+    get active(): boolean;
     /** Icon of the overlay header. */
     icon: string;
     /** If the overlay is resizable. */
@@ -456,7 +617,11 @@ declare class OverlayComponent implements AfterViewInit, OnDestroy {
     private MIN_RES_WIDTH;
     /** Minimum resizable height */
     private MIN_RES_HEIGHT;
-    constructor(eventDisplay: EventDisplayService);
+    constructor(eventDisplay: EventDisplayService, elementRef: ElementRef);
+    ngOnInit(): void;
+    toggleBodyAndEmit(): void;
+    /** Bring the overlay to the front. */
+    bringToFront(): void;
     /**
      * Move the resizable handle to the bottom right after the component is created.
      */
@@ -566,7 +731,7 @@ declare class ViewOptionsComponent implements OnInit, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<ViewOptionsComponent, "app-view-options", never, {}, {}, never, never, false, never>;
 }
 
-declare class CartesianGridConfigComponent implements OnInit {
+declare class CartesianGridConfigComponent implements OnInit, OnDestroy {
     data: {
         gridVisible: boolean;
         scale: number;
@@ -596,6 +761,11 @@ declare class CartesianGridConfigComponent implements OnInit {
     onClose(): void;
     onSave(x: any, y: any, z: any): void;
     shiftCartesianGridByPointer(): void;
+    /**
+     * Unsubscribe from the grid-shifting subscriptions, if any are active.
+     */
+    private clearShiftSubscriptions;
+    ngOnDestroy(): void;
     shiftCartesianGridByValues(position: Vector3): void;
     translateGrid(position: Vector3): void;
     addXYPlanes(zDistance: Event): void;
@@ -768,6 +938,8 @@ declare class ShareLinkDialogComponent implements AfterViewInit, OnDestroy {
         state: string;
         hideWidgets: boolean;
         embed: boolean;
+        replay: string;
+        session: string;
     };
     qrcodeCanvas: ElementRef<HTMLCanvasElement>;
     private unsubscribe;
@@ -1042,9 +1214,10 @@ declare class EtaPhiPanelOverlayComponent implements OnInit, OnDestroy, AfterVie
 
 declare class EtaPhiPanelComponent implements OnInit, OnDestroy {
     private overlay;
+    private overlayCascade;
     showPanel: boolean;
     overlayWindow: ComponentRef<EtaPhiPanelOverlayComponent>;
-    constructor(overlay: Overlay);
+    constructor(overlay: Overlay, overlayCascade: OverlayCascadeService);
     ngOnInit(): void;
     ngOnDestroy(): void;
     toggleOverlay(): void;
@@ -1121,10 +1294,11 @@ declare class KinematicsPanelOverlayComponent implements OnInit, OnDestroy {
 
 declare class KinematicsPanelComponent implements OnInit, OnDestroy, OnChanges {
     private overlay;
+    private overlayCascade;
     showKinematics: boolean;
     overlayWindow: ComponentRef<KinematicsPanelOverlayComponent>;
     config?: KinematicsConfig;
-    constructor(overlay: Overlay);
+    constructor(overlay: Overlay, overlayCascade: OverlayCascadeService);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
@@ -1232,6 +1406,82 @@ declare class MasterclassPanelComponent implements OnInit, OnDestroy, OnChanges
     static ɵcmp: i0.ɵɵComponentDeclaration<MasterclassPanelComponent, "app-masterclass-panel", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, false, never>;
 }
 
+/**
+ * Floating session pill (#883). Renders only while the session manager is
+ * recording, paused, finished, or playing a replay. Idle state hides the
+ * pill entirely so it adds zero footprint to the toolbar.
+ */
+declare class SessionPillComponent implements OnInit, OnDestroy {
+    private eventDisplay;
+    private cdr;
+    /** Current session-manager state, kept in component for template binding. */
+    state: SessionState;
+    /** Cached duration label for the recording elapsed clock. */
+    durationLabel: string;
+    /** Cached current/total label for the playback clock. */
+    playbackLabel: string;
+    /** Cached event count for the recording badge. */
+    eventCount: number;
+    /** Last computed scrub percent (0-100). */
+    scrubPercent: number;
+    /** Saved copy-link feedback flag (resets after a tick). */
+    linkCopied: boolean;
+    /** Available playback speeds for the speed selector. */
+    speeds: readonly (1 | 2 | 4 | 0.5)[];
+    private sessionManager;
+    private unsubscribeState;
+    private recordingClockId;
+    private copiedResetTimer;
+    constructor(eventDisplay: EventDisplayService, cdr: ChangeDetectorRef);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    /** True when the pill should be visible. Idle state hides it. */
+    get visible(): boolean;
+    /** Stop an active recording from the pill's stop button. */
+    onStopRecording(): void;
+    /** Dismiss a recorded/finished/errored state and return to idle. */
+    onDismiss(): void;
+    /** Start a pending (link-supplied) session after explicit user confirmation. */
+    onPlayPending(): void;
+    /** Source label + duration/event summary for the pending confirm prompt. */
+    get pendingSummary(): string;
+    /** Toggle play/pause on the active player. */
+    onTogglePlayback(): void;
+    /** Scrub to the playhead position the user clicked. */
+    onScrub(value: number): void;
+    /** Change the active player's speed. */
+    onSpeed(speed: 0.5 | 1 | 2 | 4): void;
+    /** Download the recorded session as a .phnxreplay JSON file. */
+    onDownload(): void;
+    /**
+     * Copy a ?replay=... share link to the clipboard. The base64 is precomputed
+     * when recording stops, so the common path writes synchronously inside the
+     * click gesture (the async Clipboard API rejects writes that happen after an
+     * await, which expires the user activation). Falls back to execCommand.
+     */
+    onCopyLink(): void;
+    /** Build the share URL for a base64 payload and copy it to the clipboard. */
+    private copyShareLink;
+    /**
+     * Legacy clipboard copy via a temporary textarea + execCommand. Used as a
+     * fallback when the async Clipboard API is unavailable or rejected. Mirrors
+     * the share-link dialog's proven approach.
+     * @param text The text to copy.
+     * @returns True if the copy command reported success.
+     */
+    private legacyCopy;
+    /** Active player duration (ms) for the scrub bar max value. */
+    get playerDuration(): number;
+    /** Active player current speed for the selector highlight. */
+    get currentSpeed(): number;
+    private refreshDerived;
+    private startRecordingClock;
+    private stopRecordingClock;
+    private updateRecordingDerived;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SessionPillComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SessionPillComponent, "app-session-pill", never, {}, {}, never, never, false, never>;
+}
+
 declare class ErrorMessageService {
     /** A variable that stores the latest error thrown. */
     private error;
@@ -1297,76 +1547,9 @@ 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 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 ɵmod: i0.ɵɵNgModuleDeclaration<PhoenixUIModule, [typeof NotificationToastComponent, 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 DownloadAnimationDialogComponent, 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 SessionPillComponent, typeof ShortcutsDialogComponent], [typeof i62.MatSnackBarModule, typeof AttributePipe, typeof i64.CommonModule, typeof i65.RouterModule, typeof i66.DragDropModule, typeof i67.MatDialogModule, typeof i68.MatButtonModule, typeof i69.MatTooltipModule, typeof i70.OverlayModule, typeof i71.FormsModule, typeof i71.ReactiveFormsModule, typeof i72.MatMenuModule, typeof i73.MatRadioModule, typeof i74.MatSliderModule, typeof i75.MatSlideToggleModule, typeof i76.MatCheckboxModule, typeof i77.MatIconModule, typeof i78.CdkTreeModule, typeof i79.MatTabsModule, typeof i80.MatProgressBarModule], [typeof NotificationToastComponent, 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 DownloadAnimationDialogComponent, 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 SessionPillComponent, typeof ShortcutsDialogComponent, typeof AttributePipe]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<PhoenixUIModule>;
 }
 
-/** 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 { AnimateCameraComponent, AnimateEventComponent, ArToggleComponent, AttributePipe, AutoRotateComponent, CartesianGridConfigComponent, CollectionsInfoComponent, CollectionsInfoOverlayComponent, ConfigSliderComponent, CycleEventsComponent, DarkThemeComponent, DownloadAnimationDialogComponent, 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, NotificationToastComponent, ObjectClippingComponent, ObjectSelectionComponent, ObjectSelectionOverlayComponent, OverlayCascadeService, OverlayComponent, OverlayViewComponent, OverlayViewWindowComponent, PerformanceToggleComponent, PhoenixMenuComponent, PhoenixMenuItemComponent, PhoenixUIModule, RingLoaderComponent, SSModeComponent, SessionPillComponent, ShareLinkComponent, ShareLinkDialogComponent, ShortcutsDialogComponent, 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": "4.0.1",
+  "version": "4.2.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,15 +25,15 @@
     "zone.js": "*"
   },
   "dependencies": {
-    "@angular/animations": "^20.3.23",
+    "@angular/animations": "^20.3.28",
     "@angular/cdk": "^20.2.14",
-    "@angular/forms": "^20.3.23",
+    "@angular/forms": "^20.3.28",
     "@angular/material": "^20.2.14",
-    "@angular/platform-browser": "^20.3.23",
+    "@angular/platform-browser": "^20.3.28",
     "css-element-queries": "^1.2.3",
     "qrcode": "1.5.4",
     "rxjs": "^7.8.2",
-    "three": "~0.178.0",
+    "three": "~0.184.0",
     "tslib": "^2.8.1"
   },
   "devDependencies": {
@@ -53,5 +53,5 @@
       "sass": "./_theming.scss"
     }
   },
-  "gitHead": "ac0f92015dea43ef9da91ad8bc574740817cdad0"
+  "gitHead": "64e6e89d7c5fc4a3fe013c3a65b21bdf9469233b"
 }