@fundamental-ngx/core 0.63.0-rc.2 → 0.63.0-rc.21

package/types/fundamental-ngx-core-popover.d.ts

@@ -1,17 +1,345 @@
 import * as _angular_core from '@angular/core';
-import { ElementRef, TemplateRef, OnInit, AfterContentChecked, InjectionToken, ModelSignal, EventEmitter, OnDestroy, ViewContainerRef, AfterViewInit, AfterContentInit, Signal } from '@angular/core';
-import { ScrollStrategy, ConnectedPosition, ConnectionPositionPair, CdkOverlayOrigin } from '@angular/cdk/overlay';
+import { TemplateRef, ElementRef, AfterContentChecked, AfterViewInit, AfterContentInit, OnDestroy, ViewContainerRef, OnInit, InjectionToken, ModelSignal, EventEmitter, Signal } from '@angular/core';
+import { ConnectionPositionPair, ConnectedPosition, CdkOverlayOrigin, ScrollStrategy } from '@angular/cdk/overlay';
 import { Nullable } from '@fundamental-ngx/cdk/utils';
 import { Placement, PopoverFillMode } from '@fundamental-ngx/core/shared';
+import { MobileModeConfig, MobileMode, MobileModeBase } from '@fundamental-ngx/core/mobile-mode';
 import { CdkTrapFocus } from '@angular/cdk/a11y';
 import { ContentDensityObserver } from '@fundamental-ngx/core/content-density';
 import { ScrollbarDirective } from '@fundamental-ngx/core/scrollbar';
 import { Subject } from 'rxjs';
-import { MobileMode, MobileModeBase, MobileModeConfig } from '@fundamental-ngx/core/mobile-mode';
 import * as i1 from '@fundamental-ngx/core/dialog';
 import { DialogConfig } from '@fundamental-ngx/core/dialog';
 import * as i2 from '@fundamental-ngx/core/button';
 
+declare class PopoverBodyDirective {
+    /**
+     * The template to be used as the popover's body.
+     **/
+    readonly templateRef: TemplateRef<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverBodyDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PopoverBodyDirective, "[fdPopoverBody]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * A component used to enforce a certain layout for the popover.
+ * ```html
+ * <fd-popover>
+ *     <fd-popover-control>Control Element</fd-popover-control>
+ *     <fd-popover-body>Popover Body</fd-popover-body>
+ * </fd-popover>
+ * ```
+ */
+declare class PopoverBodyComponent {
+    /** Minimum width of the popover body element. */
+    readonly minWidth: _angular_core.InputSignal<Nullable<string>>;
+    /** Maximum width of the popover body element. */
+    readonly maxWidth: _angular_core.InputSignal<Nullable<string>>;
+    /** Minimum height of the popover body element. */
+    readonly minHeight: _angular_core.InputSignal<Nullable<string>>;
+    /** Maximum height of the popover body element. */
+    readonly maxHeight: _angular_core.InputSignal<Nullable<string>>;
+    /** @hidden */
+    readonly _cdkTrapFocus: _angular_core.Signal<CdkTrapFocus | undefined>;
+    /** @hidden */
+    readonly _scrollbar: _angular_core.Signal<ScrollbarDirective | undefined>;
+    /** @hidden Whether to wrap content with fd-scrollbar directive. */
+    readonly _disableScrollbar: _angular_core.WritableSignal<boolean>;
+    /** @hidden Whether the popover should have an arrow. */
+    readonly _noArrow: _angular_core.WritableSignal<boolean>;
+    /** @hidden Whether the popover container needs an extra class for styling. */
+    readonly _additionalBodyClass: _angular_core.WritableSignal<Nullable<string>>;
+    /** @hidden Whether the popover should be focusTrapped. */
+    readonly _focusTrapped: _angular_core.WritableSignal<boolean>;
+    /**
+     * @hidden
+     * Whether the popover should automatically move focus into the trapped region upon
+     * initialization and return focus to the previous activeElement upon destruction.
+     */
+    readonly _focusAutoCapture: _angular_core.WritableSignal<boolean>;
+    /** @hidden Property bind to popover's body. */
+    readonly _popoverBodyWidth: _angular_core.WritableSignal<number | undefined>;
+    /** @hidden Property bind to popover's body. */
+    readonly _popoverBodyMinWidth: _angular_core.WritableSignal<number | undefined>;
+    /** @hidden Property bind to popover's body. */
+    readonly _maxWidth: _angular_core.WritableSignal<Nullable<number>>;
+    /** @hidden Property bind to popover's body. */
+    readonly _closeOnEscapeKey: _angular_core.WritableSignal<boolean>;
+    /** @hidden Aria role for the popover body. */
+    readonly _bodyRole: _angular_core.WritableSignal<Nullable<string>>;
+    /** @hidden Aria label for the popover body. */
+    readonly _bodyAriaLabel: _angular_core.WritableSignal<Nullable<string>>;
+    /** @hidden ID of the element that labels the popover body. */
+    readonly _bodyAriaLabelledBy: _angular_core.WritableSignal<string | null>;
+    /** @hidden ID for the popover body. */
+    readonly _bodyId: _angular_core.WritableSignal<string | null>;
+    /** @hidden Classes added to arrow element. */
+    readonly _arrowClasses: _angular_core.WritableSignal<string>;
+    /** @hidden text rendered inside popover's body. */
+    readonly text: _angular_core.WritableSignal<Nullable<string>>;
+    /** @hidden template rendered inside popover's body. */
+    readonly _templateToDisplay: _angular_core.WritableSignal<TemplateRef<any> | undefined>;
+    /** @hidden Whether the popover body is resizable. */
+    readonly _resizable: _angular_core.WritableSignal<boolean>;
+    /** @hidden */
+    readonly _resizeHandleLocation: _angular_core.WritableSignal<"top-right" | "top-left" | "bottom-right" | "bottom-left">;
+    /** Event emitted when popover body requests to be closed (e.g., Escape key press) */
+    readonly onClose: _angular_core.OutputEmitterRef<void>;
+    /** @hidden */
+    readonly _elementRef: ElementRef<any>;
+    /** @hidden */
+    readonly _contentDensityObserver: ContentDensityObserver;
+    /** @hidden */
+    private readonly _renderer;
+    /** @hidden */
+    private _bodyComponentClasses;
+    /** @hidden */
+    constructor();
+    /** Handler escape keydown */
+    bodyKeyupHandler(event: KeyboardEvent): void;
+    /** @hidden */
+    _setBodyComponentClasses(classes: string | null): void;
+    /** @hidden */
+    _setArrowStyles(position: ConnectionPositionPair, rtl: 'rtl' | 'ltr'): void;
+    /** @hidden */
+    _focusFirstTabbableElement(forced?: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverBodyComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PopoverBodyComponent, "fd-popover-body", never, { "minWidth": { "alias": "minWidth"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "minHeight": { "alias": "minHeight"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; }, { "onClose": "onClose"; }, never, ["[fd-popover-body-header]", "[fd-popover-body-subheader]", "*", "[fd-popover-body-footer]"], true, never>;
+}
+
+/**
+ * A component used to enforce a certain layout for the popover.
+ * ```html
+ * <fd-popover>
+ *     <fd-popover-control>Control Element</fd-popover-control>
+ *     <fd-popover-body>Popover Body</fd-popover-body>
+ * </fd-popover>
+ * ```
+ */
+declare class PopoverControlComponent implements AfterContentChecked {
+    elRef: ElementRef;
+    /** @hidden */
+    _tabbable: boolean;
+    /** @hidden */
+    constructor(elRef: ElementRef);
+    /** @hidden */
+    ngAfterContentChecked(): void;
+    /** @hidden */
+    makeTabbable(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverControlComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PopoverControlComponent, "fd-popover-control, [fdPopoverControl]", never, {}, {}, never, ["*"], true, never>;
+}
+
+/**
+ * ARIA role values commonly used for popover bodies. Provides autocomplete for
+ * the most frequent cases while allowing any valid ARIA role via the string escape hatch.
+ */
+type PopoverBodyRole = 'dialog' | 'region' | 'menu' | 'listbox' | 'tooltip' | 'alertdialog';
+declare const SELECT_CLASS_NAMES: {
+    selectControl: string;
+};
+/**
+ * The popover is a wrapping component that accepts a *control* as well as a *body*.
+ * The control is what will trigger the opening of the actual popover, which is called the body.
+ * By default, popovers are triggered by click. This can be customized through the *triggers* input.
+ */
+declare class PopoverComponent implements AfterViewInit, AfterContentInit, OnDestroy {
+    /**
+     * Configuration object for popover settings.
+     * When provided, these settings will be merged with individual input properties.
+     * Individual inputs take precedence over config object values.
+     */
+    readonly config: _angular_core.InputSignal<PopoverConfig>;
+    /** Tooltip for popover */
+    readonly title: _angular_core.InputSignal<string>;
+    /** Reference to popover trigger element */
+    readonly trigger: _angular_core.ModelSignal<ElementRef<any> | HTMLElement | null>;
+    /** Id of the popover. If none is provided, one will be generated. */
+    readonly id: _angular_core.InputSignal<string>;
+    /** Whether the popover component should be displayed in mobile mode. */
+    readonly mobile: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Config for the popover in mobile mode */
+    readonly mobileConfig: _angular_core.InputSignal<MobileModeConfig>;
+    /**
+     * Whether the popover should prevent page scrolling when space key is pressed.
+     **/
+    readonly preventSpaceKeyScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Popover placement */
+    readonly placement: _angular_core.InputSignal<Placement>;
+    /** Maximum width of popover body in px, prevents from overextending body by `fillControlMode` */
+    readonly maxWidth: _angular_core.InputSignal<number | null>;
+    /**
+     * Preset options for the popover body width.
+     * * `at-least` will apply a minimum width to the body equivalent to the width of the control.
+     * * `equal` will apply a width to the body equivalent to the width of the control.
+     * * Leave blank for no effect.
+     */
+    readonly fillControlMode: _angular_core.InputSignal<PopoverFillMode | null>;
+    /** Whether clicking outside popover should close it */
+    readonly closeOnOutsideClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Whether escape key should close the popover */
+    readonly closeOnEscapeKey: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Whether the popover is disabled */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Popover trigger events configuration */
+    readonly triggers: _angular_core.InputSignal<(string | TriggerConfig)[]>;
+    /** Whether the popover should trap focus */
+    readonly focusTrapped: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Whether focus should be automatically captured when popover opens */
+    readonly focusAutoCapture: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Whether to move the focus after popover is closed to the last focused element before popover was opened.
+     */
+    readonly restoreFocusOnClose: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Whether the arrow should be hidden */
+    readonly noArrow: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Whether scrollbar should be disabled */
+    readonly disableScrollbar: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** The element to which the overlay is attached. By default it is body */
+    readonly appendTo: _angular_core.InputSignal<ElementRef<any> | Element | null>;
+    /** Placement of the popover element */
+    readonly placementContainer: _angular_core.InputSignal<ElementRef<any> | Element | null>;
+    /** Scroll strategy for the overlay */
+    readonly scrollStrategy: _angular_core.InputSignal<any>;
+    /** List of position options for CDK overlay */
+    readonly cdkPositions: _angular_core.InputSignal<ConnectedPosition[] | null>;
+    /** Whether to apply a background overlay */
+    readonly applyOverlay: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Additional CSS class for the popover body container */
+    readonly additionalBodyClass: _angular_core.InputSignal<string | null>;
+    /** Additional CSS class for the popover trigger element */
+    readonly additionalTriggerClass: _angular_core.InputSignal<string | null>;
+    /** Whether to close the popover on router navigation start */
+    readonly closeOnNavigation: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Whether position shouldn't change when popover approaches the corner of page */
+    readonly fixedPosition: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Whether the popover body is resizable */
+    readonly resizable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** ARIA label for the popover body */
+    readonly bodyAriaLabel: _angular_core.InputSignal<string | null>;
+    /**
+     * ARIA role for the popover body. Default: 'dialog' (back-compat).
+     *
+     * When 'dialog', WCAG requires an accessible name — provide one via
+     * [bodyAriaLabel] or [bodyAriaLabelledBy]. Without a name, axe-core
+     * raises aria-dialog-name violations.
+     *
+     * Set to null when the popover is a non-modal disclosure widget and
+     * the trigger's aria-haspopup already carries the relationship (no role
+     * attribute is rendered). Other valid values: 'region', 'menu', 'listbox',
+     * 'tooltip', 'alertdialog' — match the role to the popover's actual semantics.
+     * Any valid ARIA role is accepted; the type provides autocomplete for common cases.
+     *
+     * @remarks When set via this input (including when unbound — defaults to 'dialog'),
+     * the PopoverConfig object's `bodyRole` field is ignored. Config-only usage
+     * is not supported for `bodyRole` because the input has a concrete default.
+     * To override, bind the input explicitly: `[bodyRole]="'region'"` or `[bodyRole]="null"`.
+     *
+     * See https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/ for guidance.
+     */
+    readonly bodyRole: _angular_core.InputSignal<PopoverBodyRole | (string & {}) | null>;
+    /**
+     * ID of the element that labels the popover body. Alternative to
+     * [bodyAriaLabel] when the label already exists in the DOM (e.g. the
+     * trigger's text). Sets aria-labelledby on the popover body.
+     */
+    readonly bodyAriaLabelledBy: _angular_core.InputSignal<string | null>;
+    /** Two-way binding for popover open state */
+    readonly isOpen: _angular_core.ModelSignal<boolean>;
+    /** Event emitted when the state of the isOpen property changes. */
+    readonly isOpenChange: _angular_core.OutputEmitterRef<boolean>;
+    /** Event emitted right before the popover is being opened. */
+    readonly beforeOpen: _angular_core.OutputEmitterRef<void>;
+    /** @hidden */
+    readonly templateRef: _angular_core.Signal<TemplateRef<any> | undefined>;
+    /** @hidden */
+    readonly container: _angular_core.Signal<ViewContainerRef | undefined>;
+    /** @hidden */
+    readonly triggerOrigin: _angular_core.Signal<CdkOverlayOrigin | undefined>;
+    /** @hidden */
+    readonly popoverBody: _angular_core.Signal<PopoverBodyComponent | undefined>;
+    /** @hidden */
+    readonly popoverBodyDirective: _angular_core.Signal<PopoverBodyDirective | undefined>;
+    /** @hidden */
+    readonly popoverControl: _angular_core.Signal<PopoverControlComponent | undefined>;
+    /** @hidden - template for Dialog body content */
+    readonly popoverBodyContentTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
+    /** @hidden - template for Dialog footer content */
+    readonly popoverFooterContentTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
+    /** @hidden */
+    get _triggerElement(): HTMLElement | null;
+    /** @hidden */
+    private readonly _popoverService;
+    /** @hidden */
+    private readonly _renderer;
+    /** @hidden */
+    private readonly _viewContainerRef;
+    /** @hidden */
+    private readonly _injector;
+    /** @hidden */
+    private readonly _dynamicComponentService;
+    /** @hidden */
+    private readonly _destroyRef;
+    /** @hidden */
+    private _clickEventListener;
+    /** @hidden */
+    private _mobileModeComponentRef;
+    /** @hidden Flag to prevent circular sync between component and service */
+    private _syncingIsOpen;
+    /** @hidden Computed signal that merges config with individual inputs */
+    private readonly _effectiveConfig;
+    /** @hidden */
+    constructor();
+    /** @hidden */
+    ngAfterViewInit(): void;
+    /** @hidden */
+    ngAfterContentInit(): void;
+    /** @hidden */
+    ngOnDestroy(): void;
+    /** Toggles menu open/close state */
+    toggle(): void;
+    /** Opens the popover. */
+    open(): void;
+    /** Closes the popover. */
+    close(focusActiveElement?: boolean): void;
+    /** Temporary sets the ignoring of the event triggers. */
+    setIgnoreTriggers(ignore: boolean): void;
+    /**
+     * Method called to change position of popover,
+     * recommended to be used only when popover is opened, otherwise change position or cdkPlacement
+     */
+    applyNewPosition(positions: ConnectedPosition[]): void;
+    /** Method called to refresh position of opened popover */
+    refreshPosition(): void;
+    /** Handler for alt + arrow down keydown */
+    triggerKeyDownHandler(event: KeyboardEvent): void;
+    /** Handler escape keydown */
+    protected _onEscapeKey(event: Event): void;
+    /** @hidden */
+    protected _onKeyDown(event: Event): void;
+    /** @hidden - Sync all input signals to the service */
+    private _syncToService;
+    /** @hidden Select and instantiate popover view mode */
+    private _setupView;
+    /**
+     * Depending on a used popover body type, returns a popover body content
+     **/
+    private _getPopoverBodyContent;
+    /** @hidden Open Popover in mobile mode */
+    private _setupMobileMode;
+    /** @hidden - Listen on popover trigger ref clicks */
+    private _listenOnTriggerRefClicks;
+    /**
+     * @hidden
+     * This is going to be removed in feature, on dialog and dynamic service component refactor
+     */
+    private _destroyEventListeners;
+    /** @hidden */
+    private _destroyMobileComponent;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PopoverComponent, "fd-popover", never, { "config": { "alias": "config"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "trigger": { "alias": "trigger"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "mobile": { "alias": "mobile"; "required": false; "isSignal": true; }; "mobileConfig": { "alias": "mobileConfig"; "required": false; "isSignal": true; }; "preventSpaceKeyScroll": { "alias": "preventSpaceKeyScroll"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "fillControlMode": { "alias": "fillControlMode"; "required": false; "isSignal": true; }; "closeOnOutsideClick": { "alias": "closeOnOutsideClick"; "required": false; "isSignal": true; }; "closeOnEscapeKey": { "alias": "closeOnEscapeKey"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "triggers": { "alias": "triggers"; "required": false; "isSignal": true; }; "focusTrapped": { "alias": "focusTrapped"; "required": false; "isSignal": true; }; "focusAutoCapture": { "alias": "focusAutoCapture"; "required": false; "isSignal": true; }; "restoreFocusOnClose": { "alias": "restoreFocusOnClose"; "required": false; "isSignal": true; }; "noArrow": { "alias": "noArrow"; "required": false; "isSignal": true; }; "disableScrollbar": { "alias": "disableScrollbar"; "required": false; "isSignal": true; }; "appendTo": { "alias": "appendTo"; "required": false; "isSignal": true; }; "placementContainer": { "alias": "placementContainer"; "required": false; "isSignal": true; }; "scrollStrategy": { "alias": "scrollStrategy"; "required": false; "isSignal": true; }; "cdkPositions": { "alias": "cdkPositions"; "required": false; "isSignal": true; }; "applyOverlay": { "alias": "applyOverlay"; "required": false; "isSignal": true; }; "additionalBodyClass": { "alias": "additionalBodyClass"; "required": false; "isSignal": true; }; "additionalTriggerClass": { "alias": "additionalTriggerClass"; "required": false; "isSignal": true; }; "closeOnNavigation": { "alias": "closeOnNavigation"; "required": false; "isSignal": true; }; "fixedPosition": { "alias": "fixedPosition"; "required": false; "isSignal": true; }; "resizable": { "alias": "resizable"; "required": false; "isSignal": true; }; "bodyAriaLabel": { "alias": "bodyAriaLabel"; "required": false; "isSignal": true; }; "bodyRole": { "alias": "bodyRole"; "required": false; "isSignal": true; }; "bodyAriaLabelledBy": { "alias": "bodyAriaLabelledBy"; "required": false; "isSignal": true; }; "isOpen": { "alias": "isOpen"; "required": false; "isSignal": true; }; }, { "trigger": "triggerChange"; "isOpen": "isOpenChange"; "isOpenChange": "isOpenChange"; "beforeOpen": "beforeOpen"; }, ["popoverBody", "popoverBodyDirective", "popoverControl", "popoverBodyContentTemplate", "popoverFooterContentTemplate"], ["fd-popover-control, [fdPopoverControl]", "fd-popover-body", "*"], true, never>;
+}
+
 /**
  * Configuration object for popover trigger events.
  * Allows specifying whether an event should apply for open and/or close actions.
@@ -121,10 +449,12 @@ interface PopoverConfig {
     fixedPosition?: boolean;
     /** Whether the popover body is resizable. */
     resizable?: boolean;
-    /** ARIA role for the popover body. */
-    bodyRole?: string | null;
+    /** ARIA role for the popover body. Common values: 'dialog', 'region', 'menu', 'listbox', 'tooltip', 'alertdialog'. */
+    bodyRole?: PopoverBodyRole | (string & {}) | null;
     /** ARIA label for the popover body. */
     bodyAriaLabel?: string | null;
+    /** ID of the element that labels the popover body. */
+    bodyAriaLabelledBy?: string | null;
     /** ID for the popover body. */
     bodyId?: string | null;
 }
@@ -244,125 +574,32 @@ declare class BasePopoverClass {
     fillControlMode: _angular_core.WritableSignal<Nullable<PopoverFillMode>>;
     /** The element to which  the overlay is attached. By default it is body */
     appendTo: _angular_core.WritableSignal<Nullable<ElementRef<any> | Element>>;
-    /** Placement of the popover element. */
-    placementContainer: _angular_core.WritableSignal<Nullable<ElementRef<any> | Element>>;
-    /** Whether position shouldn't change, when popover approach the corner of page */
-    fixedPosition: _angular_core.WritableSignal<boolean>;
-    /** Whether the popover body is resizable. */
-    resizable: _angular_core.WritableSignal<boolean>;
-    /** @hidden Aria role for the popover body. */
-    protected _bodyRole: string | null;
-    /** @hidden ID for the popover body. */
-    protected readonly _bodyId: _angular_core.WritableSignal<string | null>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<BasePopoverClass, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BasePopoverClass, never, never, {}, {}, never, never, true, never>;
-}
-
-declare class PopoverBodyDirective {
-    /**
-     * The template to be used as the popover's body.
-     **/
-    readonly templateRef: TemplateRef<void>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverBodyDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PopoverBodyDirective, "[fdPopoverBody]", never, {}, {}, never, never, true, never>;
-}
-
-declare class PopoverBodyFooterDirective {
-    /** @hidden */
-    fdPopoverBodyFooterClass: boolean;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverBodyFooterDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PopoverBodyFooterDirective, "[fdPopoverBodyFooter], [fd-popover-body-footer]", never, {}, {}, never, never, true, never>;
-}
-
-declare class PopoverBodyHeaderDirective {
-    /** @hidden */
-    fdPopoverBodyHeaderClass: boolean;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverBodyHeaderDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PopoverBodyHeaderDirective, "[fdPopoverBodyHeader], [fd-popover-body-header]", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * A component used to enforce a certain layout for the popover.
- * ```html
- * <fd-popover>
- *     <fd-popover-control>Control Element</fd-popover-control>
- *     <fd-popover-body>Popover Body</fd-popover-body>
- * </fd-popover>
- * ```
- */
-declare class PopoverBodyComponent {
-    /** Minimum width of the popover body element. */
-    readonly minWidth: _angular_core.InputSignal<Nullable<string>>;
-    /** Maximum width of the popover body element. */
-    readonly maxWidth: _angular_core.InputSignal<Nullable<string>>;
-    /** Minimum height of the popover body element. */
-    readonly minHeight: _angular_core.InputSignal<Nullable<string>>;
-    /** Maximum height of the popover body element. */
-    readonly maxHeight: _angular_core.InputSignal<Nullable<string>>;
-    /** @hidden */
-    readonly _cdkTrapFocus: _angular_core.Signal<CdkTrapFocus | undefined>;
-    /** @hidden */
-    readonly _scrollbar: _angular_core.Signal<ScrollbarDirective | undefined>;
-    /** @hidden Whether to wrap content with fd-scrollbar directive. */
-    readonly _disableScrollbar: _angular_core.WritableSignal<boolean>;
-    /** @hidden Whether the popover should have an arrow. */
-    readonly _noArrow: _angular_core.WritableSignal<boolean>;
-    /** @hidden Whether the popover container needs an extra class for styling. */
-    readonly _additionalBodyClass: _angular_core.WritableSignal<Nullable<string>>;
-    /** @hidden Whether the popover should be focusTrapped. */
-    readonly _focusTrapped: _angular_core.WritableSignal<boolean>;
-    /**
-     * @hidden
-     * Whether the popover should automatically move focus into the trapped region upon
-     * initialization and return focus to the previous activeElement upon destruction.
-     */
-    readonly _focusAutoCapture: _angular_core.WritableSignal<boolean>;
-    /** @hidden Property bind to popover's body. */
-    readonly _popoverBodyWidth: _angular_core.WritableSignal<number | undefined>;
-    /** @hidden Property bind to popover's body. */
-    readonly _popoverBodyMinWidth: _angular_core.WritableSignal<number | undefined>;
-    /** @hidden Property bind to popover's body. */
-    readonly _maxWidth: _angular_core.WritableSignal<Nullable<number>>;
-    /** @hidden Property bind to popover's body. */
-    readonly _closeOnEscapeKey: _angular_core.WritableSignal<boolean>;
+    /** Placement of the popover element. */
+    placementContainer: _angular_core.WritableSignal<Nullable<ElementRef<any> | Element>>;
+    /** Whether position shouldn't change, when popover approach the corner of page */
+    fixedPosition: _angular_core.WritableSignal<boolean>;
+    /** Whether the popover body is resizable. */
+    resizable: _angular_core.WritableSignal<boolean>;
     /** @hidden Aria role for the popover body. */
-    readonly _bodyRole: _angular_core.WritableSignal<Nullable<string>>;
-    /** @hidden Aria label for the popover body. */
-    readonly _bodyAriaLabel: _angular_core.WritableSignal<Nullable<string>>;
+    protected _bodyRole: string | null;
     /** @hidden ID for the popover body. */
-    readonly _bodyId: _angular_core.WritableSignal<string | null>;
-    /** @hidden Classes added to arrow element. */
-    readonly _arrowClasses: _angular_core.WritableSignal<string>;
-    /** @hidden text rendered inside popover's body. */
-    readonly text: _angular_core.WritableSignal<Nullable<string>>;
-    /** @hidden template rendered inside popover's body. */
-    readonly _templateToDisplay: _angular_core.WritableSignal<TemplateRef<any> | undefined>;
-    /** @hidden Whether the popover body is resizable. */
-    readonly _resizable: _angular_core.WritableSignal<boolean>;
-    /** @hidden */
-    readonly _resizeHandleLocation: _angular_core.WritableSignal<"top-right" | "top-left" | "bottom-right" | "bottom-left">;
-    /** Event emitted when popover body requests to be closed (e.g., Escape key press) */
-    readonly onClose: _angular_core.OutputEmitterRef<void>;
-    /** @hidden */
-    readonly _elementRef: ElementRef<any>;
-    /** @hidden */
-    readonly _contentDensityObserver: ContentDensityObserver;
-    /** @hidden */
-    private readonly _renderer;
-    /** @hidden */
-    private _bodyComponentClasses;
-    /** @hidden */
-    constructor();
-    /** Handler escape keydown */
-    bodyKeyupHandler(event: KeyboardEvent): void;
-    /** @hidden */
-    _setBodyComponentClasses(classes: string | null): void;
+    protected readonly _bodyId: _angular_core.WritableSignal<string | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<BasePopoverClass, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BasePopoverClass, never, never, {}, {}, never, never, true, never>;
+}
+
+declare class PopoverBodyFooterDirective {
     /** @hidden */
-    _setArrowStyles(position: ConnectionPositionPair, rtl: 'rtl' | 'ltr'): void;
+    fdPopoverBodyFooterClass: boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverBodyFooterDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PopoverBodyFooterDirective, "[fdPopoverBodyFooter], [fd-popover-body-footer]", never, {}, {}, never, never, true, never>;
+}
+
+declare class PopoverBodyHeaderDirective {
     /** @hidden */
-    _focusFirstTabbableElement(forced?: boolean): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverBodyComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PopoverBodyComponent, "fd-popover-body", never, { "minWidth": { "alias": "minWidth"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "minHeight": { "alias": "minHeight"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; }, { "onClose": "onClose"; }, never, ["[fd-popover-body-header]", "[fd-popover-body-subheader]", "*", "[fd-popover-body-footer]"], true, never>;
+    fdPopoverBodyHeaderClass: boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverBodyHeaderDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PopoverBodyHeaderDirective, "[fdPopoverBodyHeader], [fd-popover-body-header]", never, {}, {}, never, never, true, never>;
 }
 
 interface PopoverChildContent {
@@ -384,29 +621,6 @@ declare class PopoverContainerDirective implements OnInit {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PopoverContainerDirective, "[fdPopoverContainer]", never, {}, {}, never, never, true, never>;
 }
 
-/**
- * A component used to enforce a certain layout for the popover.
- * ```html
- * <fd-popover>
- *     <fd-popover-control>Control Element</fd-popover-control>
- *     <fd-popover-body>Popover Body</fd-popover-body>
- * </fd-popover>
- * ```
- */
-declare class PopoverControlComponent implements AfterContentChecked {
-    elRef: ElementRef;
-    /** @hidden */
-    _tabbable: boolean;
-    /** @hidden */
-    constructor(elRef: ElementRef);
-    /** @hidden */
-    ngAfterContentChecked(): void;
-    /** @hidden */
-    makeTabbable(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverControlComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PopoverControlComponent, "fd-popover-control, [fdPopoverControl]", never, {}, {}, never, ["*"], true, never>;
-}
-
 declare const POPOVER_COMPONENT: InjectionToken<PopoverInterface>;
 /**
  * Popover Interface to have typing and avoid circular dependency between
@@ -526,6 +740,8 @@ declare class PopoverService {
     protected _bodyRole: string | null;
     /** @hidden Aria label for the popover body. */
     protected _bodyAriaLabel: string | null;
+    /** @hidden ID of the element that labels the popover body. */
+    protected _bodyAriaLabelledBy: string | null;
     /** @hidden ID for the popover body. */
     protected readonly _bodyId: _angular_core.WritableSignal<string | null>;
     /** @hidden */
@@ -574,6 +790,8 @@ declare class PopoverService {
     private readonly _viewportRuler;
     /** @hidden */
     private readonly _injector;
+    /** @hidden Watches DOM mutations within the scroll container when the popover is open to reposition after layout shifts (e.g. display:none on siblings). */
+    private _ancestorMutationObserver;
     /** @hidden */
     private get _triggerHtmlElement();
     /** @hidden Flag to prevent infinite loop when programmatically opening/closing */
@@ -693,186 +911,27 @@ declare class PopoverService {
     private _focusFirstTabbableElement;
     /** @hidden */
     private _focusLastActiveElementBeforeOpen;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<PopoverService>;
-}
-
-declare const SELECT_CLASS_NAMES: {
-    selectControl: string;
-};
-/**
- * The popover is a wrapping component that accepts a *control* as well as a *body*.
- * The control is what will trigger the opening of the actual popover, which is called the body.
- * By default, popovers are triggered by click. This can be customized through the *triggers* input.
- */
-declare class PopoverComponent implements AfterViewInit, AfterContentInit, OnDestroy {
-    /**
-     * Configuration object for popover settings.
-     * When provided, these settings will be merged with individual input properties.
-     * Individual inputs take precedence over config object values.
-     */
-    readonly config: _angular_core.InputSignal<PopoverConfig>;
-    /** Tooltip for popover */
-    readonly title: _angular_core.InputSignal<string>;
-    /** Reference to popover trigger element */
-    readonly trigger: _angular_core.ModelSignal<ElementRef<any> | HTMLElement | null>;
-    /** Id of the popover. If none is provided, one will be generated. */
-    readonly id: _angular_core.InputSignal<string>;
-    /** Whether the popover component should be displayed in mobile mode. */
-    readonly mobile: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Config for the popover in mobile mode */
-    readonly mobileConfig: _angular_core.InputSignal<MobileModeConfig>;
-    /**
-     * Whether the popover should prevent page scrolling when space key is pressed.
-     **/
-    readonly preventSpaceKeyScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Popover placement */
-    readonly placement: _angular_core.InputSignal<Placement>;
-    /** Maximum width of popover body in px, prevents from overextending body by `fillControlMode` */
-    readonly maxWidth: _angular_core.InputSignal<number | null>;
-    /**
-     * Preset options for the popover body width.
-     * * `at-least` will apply a minimum width to the body equivalent to the width of the control.
-     * * `equal` will apply a width to the body equivalent to the width of the control.
-     * * Leave blank for no effect.
-     */
-    readonly fillControlMode: _angular_core.InputSignal<PopoverFillMode | null>;
-    /** Whether clicking outside popover should close it */
-    readonly closeOnOutsideClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Whether escape key should close the popover */
-    readonly closeOnEscapeKey: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Whether the popover is disabled */
-    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Popover trigger events configuration */
-    readonly triggers: _angular_core.InputSignal<(string | TriggerConfig)[]>;
-    /** Whether the popover should trap focus */
-    readonly focusTrapped: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Whether focus should be automatically captured when popover opens */
-    readonly focusAutoCapture: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /**
-     * Whether to move the focus after popover is closed to the last focused element before popover was opened.
-     */
-    readonly restoreFocusOnClose: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Whether the arrow should be hidden */
-    readonly noArrow: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Whether scrollbar should be disabled */
-    readonly disableScrollbar: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** The element to which the overlay is attached. By default it is body */
-    readonly appendTo: _angular_core.InputSignal<ElementRef<any> | Element | null>;
-    /** Placement of the popover element */
-    readonly placementContainer: _angular_core.InputSignal<ElementRef<any> | Element | null>;
-    /** Scroll strategy for the overlay */
-    readonly scrollStrategy: _angular_core.InputSignal<any>;
-    /** List of position options for CDK overlay */
-    readonly cdkPositions: _angular_core.InputSignal<ConnectedPosition[] | null>;
-    /** Whether to apply a background overlay */
-    readonly applyOverlay: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Additional CSS class for the popover body container */
-    readonly additionalBodyClass: _angular_core.InputSignal<string | null>;
-    /** Additional CSS class for the popover trigger element */
-    readonly additionalTriggerClass: _angular_core.InputSignal<string | null>;
-    /** Whether to close the popover on router navigation start */
-    readonly closeOnNavigation: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Whether position shouldn't change when popover approaches the corner of page */
-    readonly fixedPosition: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Whether the popover body is resizable */
-    readonly resizable: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** ARIA label for the popover body */
-    readonly bodyAriaLabel: _angular_core.InputSignal<string | null>;
-    /** Two-way binding for popover open state */
-    readonly isOpen: _angular_core.ModelSignal<boolean>;
-    /** Event emitted when the state of the isOpen property changes. */
-    readonly isOpenChange: _angular_core.OutputEmitterRef<boolean>;
-    /** Event emitted right before the popover is being opened. */
-    readonly beforeOpen: _angular_core.OutputEmitterRef<void>;
-    /** @hidden */
-    readonly templateRef: _angular_core.Signal<TemplateRef<any> | undefined>;
-    /** @hidden */
-    readonly container: _angular_core.Signal<ViewContainerRef | undefined>;
-    /** @hidden */
-    readonly triggerOrigin: _angular_core.Signal<CdkOverlayOrigin | undefined>;
-    /** @hidden */
-    readonly popoverBody: _angular_core.Signal<PopoverBodyComponent | undefined>;
-    /** @hidden */
-    readonly popoverBodyDirective: _angular_core.Signal<PopoverBodyDirective | undefined>;
-    /** @hidden */
-    readonly popoverControl: _angular_core.Signal<PopoverControlComponent | undefined>;
-    /** @hidden - template for Dialog body content */
-    readonly popoverBodyContentTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
-    /** @hidden - template for Dialog footer content */
-    readonly popoverFooterContentTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
-    /** @hidden */
-    get _triggerElement(): HTMLElement | null;
-    /** @hidden */
-    private readonly _popoverService;
-    /** @hidden */
-    private readonly _renderer;
-    /** @hidden */
-    private readonly _viewContainerRef;
-    /** @hidden */
-    private readonly _injector;
-    /** @hidden */
-    private readonly _dynamicComponentService;
-    /** @hidden */
-    private readonly _destroyRef;
-    /** @hidden */
-    private _clickEventListener;
-    /** @hidden */
-    private _mobileModeComponentRef;
-    /** @hidden Flag to prevent circular sync between component and service */
-    private _syncingIsOpen;
-    /** @hidden Computed signal that merges config with individual inputs */
-    private readonly _effectiveConfig;
-    /** @hidden */
-    constructor();
-    /** @hidden */
-    ngAfterViewInit(): void;
-    /** @hidden */
-    ngAfterContentInit(): void;
-    /** @hidden */
-    ngOnDestroy(): void;
-    /** Toggles menu open/close state */
-    toggle(): void;
-    /** Opens the popover. */
-    open(): void;
-    /** Closes the popover. */
-    close(focusActiveElement?: boolean): void;
-    /** Temporary sets the ignoring of the event triggers. */
-    setIgnoreTriggers(ignore: boolean): void;
     /**
-     * Method called to change position of popover,
-     * recommended to be used only when popover is opened, otherwise change position or cdkPlacement
+     * @hidden
+     * Starts a MutationObserver on the nearest scrollable ancestor of the trigger element (falling
+     * back to document.body) to detect layout shifts that would invalidate the overlay position.
+     * Two mutation types are observed within the subtree:
+     *  - `childList`: catches elements being added to or removed from the DOM (e.g. a banner/toast
+     *    that is fully removed after its timer expires).
+     *  - `attributes` with `attributeFilter: ['style', 'class']`: catches visibility toggling via
+     *    CSS (e.g. `display: none` applied inline or through a utility class, as the
+     *    `fd-message-strip` autoDismiss directive does).
+     * The callback is debounced through `requestAnimationFrame` so that rapid batched mutations
+     * (Angular rendering a whole subtree at once) only trigger a single `updatePosition()` call.
      */
-    applyNewPosition(positions: ConnectedPosition[]): void;
-    /** Method called to refresh position of opened popover */
-    refreshPosition(): void;
-    /** Handler for alt + arrow down keydown */
-    triggerKeyDownHandler(event: KeyboardEvent): void;
-    /** Handler escape keydown */
-    protected _onEscapeKey(event: Event): void;
-    /** @hidden */
-    protected _onKeyDown(event: Event): void;
-    /** @hidden - Sync all input signals to the service */
-    private _syncToService;
-    /** @hidden Select and instantiate popover view mode */
-    private _setupView;
-    /**
-     * Depending on a used popover body type, returns a popover body content
-     **/
-    private _getPopoverBodyContent;
-    /** @hidden Open Popover in mobile mode */
-    private _setupMobileMode;
-    /** @hidden - Listen on popover trigger ref clicks */
-    private _listenOnTriggerRefClicks;
+    private _startAncestorResizeObserver;
     /**
      * @hidden
-     * This is going to be removed in feature, on dialog and dynamic service component refactor
+     * Returns the nearest scrollable ancestor, or document.body when none is found.
      */
-    private _destroyEventListeners;
-    /** @hidden */
-    private _destroyMobileComponent;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PopoverComponent, "fd-popover", never, { "config": { "alias": "config"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "trigger": { "alias": "trigger"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "mobile": { "alias": "mobile"; "required": false; "isSignal": true; }; "mobileConfig": { "alias": "mobileConfig"; "required": false; "isSignal": true; }; "preventSpaceKeyScroll": { "alias": "preventSpaceKeyScroll"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "fillControlMode": { "alias": "fillControlMode"; "required": false; "isSignal": true; }; "closeOnOutsideClick": { "alias": "closeOnOutsideClick"; "required": false; "isSignal": true; }; "closeOnEscapeKey": { "alias": "closeOnEscapeKey"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "triggers": { "alias": "triggers"; "required": false; "isSignal": true; }; "focusTrapped": { "alias": "focusTrapped"; "required": false; "isSignal": true; }; "focusAutoCapture": { "alias": "focusAutoCapture"; "required": false; "isSignal": true; }; "restoreFocusOnClose": { "alias": "restoreFocusOnClose"; "required": false; "isSignal": true; }; "noArrow": { "alias": "noArrow"; "required": false; "isSignal": true; }; "disableScrollbar": { "alias": "disableScrollbar"; "required": false; "isSignal": true; }; "appendTo": { "alias": "appendTo"; "required": false; "isSignal": true; }; "placementContainer": { "alias": "placementContainer"; "required": false; "isSignal": true; }; "scrollStrategy": { "alias": "scrollStrategy"; "required": false; "isSignal": true; }; "cdkPositions": { "alias": "cdkPositions"; "required": false; "isSignal": true; }; "applyOverlay": { "alias": "applyOverlay"; "required": false; "isSignal": true; }; "additionalBodyClass": { "alias": "additionalBodyClass"; "required": false; "isSignal": true; }; "additionalTriggerClass": { "alias": "additionalTriggerClass"; "required": false; "isSignal": true; }; "closeOnNavigation": { "alias": "closeOnNavigation"; "required": false; "isSignal": true; }; "fixedPosition": { "alias": "fixedPosition"; "required": false; "isSignal": true; }; "resizable": { "alias": "resizable"; "required": false; "isSignal": true; }; "bodyAriaLabel": { "alias": "bodyAriaLabel"; "required": false; "isSignal": true; }; "isOpen": { "alias": "isOpen"; "required": false; "isSignal": true; }; }, { "trigger": "triggerChange"; "isOpen": "isOpenChange"; "isOpenChange": "isOpenChange"; "beforeOpen": "beforeOpen"; }, ["popoverBody", "popoverBodyDirective", "popoverControl", "popoverBodyContentTemplate", "popoverFooterContentTemplate"], ["fd-popover-control, [fdPopoverControl]", "fd-popover-body", "*"], true, never>;
+    private _findScrollableAncestor;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<PopoverService>;
 }
 
 declare class PopoverTriggerDirective implements OnDestroy {
@@ -939,4 +998,4 @@ type PopoverConfigSignals = {
 declare function buildPopoverConfig(signals: PopoverConfigSignals): Signal<PopoverConfig>;
 
 export { BasePopoverClass, FD_POPOVER_COMPONENT, POPOVER_COMPONENT, PopoverBodyComponent, PopoverBodyDirective, PopoverBodyFooterDirective, PopoverBodyHeaderDirective, PopoverComponent, PopoverContainerDirective, PopoverControlComponent, PopoverMobileComponent, PopoverMobileModule, PopoverModule, PopoverService, PopoverTriggerDirective, SELECT_CLASS_NAMES, buildPopoverConfig };
-export type { PopoverChildContent, PopoverConfig, PopoverConfigSignals, PopoverInterface, PopoverTemplate, TriggerConfig };
+export type { PopoverBodyRole, PopoverChildContent, PopoverConfig, PopoverConfigSignals, PopoverInterface, PopoverTemplate, TriggerConfig };