@flusys/ng-ui 8.1.2 → 8.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flusys/ng-ui",
-  "version": "8.1.2",
+  "version": "8.1.4",
   "description": "FLUSYS native UI component library ",
   "license": "MIT",
   "peerDependencies": {

package/types/flusys-ng-ui.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { EnvironmentProviders, TemplateRef, OnDestroy, AfterViewInit, OnInit, ElementRef, InjectionToken, Type, Injector } from '@angular/core';
+import { EnvironmentProviders, TemplateRef, OnDestroy, AfterViewInit, OnInit, ElementRef, InjectionToken, Type, Injector, Signal } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import * as rxjs from 'rxjs';
 
@@ -271,10 +271,10 @@ interface TreeNode<T = unknown> {
 
 declare class ConfirmDialog {
     private static idCounter;
-    private readonly _doc;
     protected readonly headerId: string;
     protected readonly descId: string;
     readonly confirmationService: ConfirmationService;
+    private readonly _overlayStack;
     readonly key: _angular_core.InputSignal<string | undefined>;
     readonly icon: _angular_core.InputSignal<string>;
     readonly acceptLabel: _angular_core.InputSignal<string>;
@@ -291,6 +291,9 @@ declare class ConfirmDialog {
     readonly activeConfirmation: _angular_core.Signal<UiConfirmation | null>;
     private readonly panelRef;
     private _previouslyFocused;
+    private _scrollLocked;
+    private readonly _zIndex;
+    readonly zIndex: _angular_core.Signal<number | null>;
     constructor();
     resolvedIcon(c: {
         icon?: string;
@@ -605,8 +608,11 @@ declare class ImageComponent {
     readonly hostClass: _angular_core.Signal<string>;
     private readonly fTemplates;
     readonly indicatorTpl: _angular_core.Signal<_angular_core.TemplateRef<any> | null>;
+    private readonly _overlayStack;
     private readonly _previewVisible;
     readonly previewVisible: _angular_core.Signal<boolean>;
+    private readonly _zIndex;
+    readonly zIndex: _angular_core.Signal<number | null>;
     private readonly _loaded;
     readonly loaded: _angular_core.Signal<boolean>;
     private readonly _hasError;
@@ -731,6 +737,13 @@ declare class SelectComponent implements ControlValueAccessor {
     readonly virtualScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly virtualScrollItemSize: _angular_core.InputSignal<number>;
     readonly lazy: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Full option object for the current `value()`, supplied by the consumer.
+     * Pinned into the option pool (deduped by `optionValue`) whenever a lazy-loaded
+     * or filtered `options()` page doesn't happen to contain it, so the trigger
+     * label, checkmark and list row always resolve correctly on edit forms.
+     */
+    readonly selectedObject: _angular_core.InputSignal<unknown>;
     readonly hostClass: _angular_core.Signal<string>;
     readonly onFilter: _angular_core.OutputEmitterRef<{
         filter: string;
@@ -756,13 +769,9 @@ declare class SelectComponent implements ControlValueAccessor {
     private readonly _editableInputRef;
     private readonly _filterInputRef;
     private readonly _panelRef;
-    private readonly _panelTop;
-    private readonly _panelLeft;
-    private readonly _panelWidth;
+    private readonly _placement;
     readonly panelClass: _angular_core.Signal<string>;
     readonly panelStyle: _angular_core.Signal<Record<string, string>>;
-    private position;
-    private adjustForViewport;
     readonly selectedItemRef: _angular_core.Signal<TemplateRef<unknown> | undefined>;
     readonly itemRef: _angular_core.Signal<TemplateRef<unknown> | undefined>;
     readonly groupRef: _angular_core.Signal<TemplateRef<unknown> | undefined>;
@@ -791,6 +800,9 @@ declare class SelectComponent implements ControlValueAccessor {
     readonly filterFieldList: _angular_core.Signal<string[]>;
     private matchesFilter;
     private optionMatchesQuery;
+    private readonly selectedObjectEntry;
+    private mergeSelected;
+    readonly optionsWithSelected: _angular_core.Signal<unknown[]>;
     readonly filteredOptions: _angular_core.Signal<unknown[]>;
     readonly allLeafOptions: _angular_core.Signal<unknown[]>;
     readonly flatItems: _angular_core.Signal<FSelectFlatItem[]>;
@@ -823,7 +835,7 @@ declare class SelectComponent implements ControlValueAccessor {
     registerOnTouched(fn: () => void): void;
     setDisabledState(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "f-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionLabel": { "alias": "optionLabel"; "required": false; "isSignal": true; }; "optionValue": { "alias": "optionValue"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "filterBy": { "alias": "filterBy"; "required": false; "isSignal": true; }; "filterMatchMode": { "alias": "filterMatchMode"; "required": false; "isSignal": true; }; "filterLocale": { "alias": "filterLocale"; "required": false; "isSignal": true; }; "filterPlaceholder": { "alias": "filterPlaceholder"; "required": false; "isSignal": true; }; "resetFilterOnHide": { "alias": "resetFilterOnHide"; "required": false; "isSignal": true; }; "autofocusFilter": { "alias": "autofocusFilter"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "emptyFilterMessage": { "alias": "emptyFilterMessage"; "required": false; "isSignal": true; }; "showClear": { "alias": "showClear"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "loadingIcon": { "alias": "loadingIcon"; "required": false; "isSignal": true; }; "dropdownIcon": { "alias": "dropdownIcon"; "required": false; "isSignal": true; }; "clearIcon": { "alias": "clearIcon"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "styleClass": { "alias": "styleClass"; "required": false; "isSignal": true; }; "style": { "alias": "style"; "required": false; "isSignal": true; }; "appendTo": { "alias": "appendTo"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "checkmark": { "alias": "checkmark"; "required": false; "isSignal": true; }; "group": { "alias": "group"; "required": false; "isSignal": true; }; "optionGroupLabel": { "alias": "optionGroupLabel"; "required": false; "isSignal": true; }; "optionGroupChildren": { "alias": "optionGroupChildren"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualScrollItemSize": { "alias": "virtualScrollItemSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; }, { "onFilter": "onFilter"; "onChange": "onChange"; "onShow": "onShow"; "onHide": "onHide"; "onBlur": "onBlur"; "onFocus": "onFocus"; "onClear": "onClear"; "onLazyLoad": "onLazyLoad"; }, ["selectedItemRef", "itemRef", "groupRef", "headerRef", "footerRef", "emptyRef", "emptyFilterRef", "loaderRef", "filterRef", "fTemplates"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "f-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionLabel": { "alias": "optionLabel"; "required": false; "isSignal": true; }; "optionValue": { "alias": "optionValue"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "filterBy": { "alias": "filterBy"; "required": false; "isSignal": true; }; "filterMatchMode": { "alias": "filterMatchMode"; "required": false; "isSignal": true; }; "filterLocale": { "alias": "filterLocale"; "required": false; "isSignal": true; }; "filterPlaceholder": { "alias": "filterPlaceholder"; "required": false; "isSignal": true; }; "resetFilterOnHide": { "alias": "resetFilterOnHide"; "required": false; "isSignal": true; }; "autofocusFilter": { "alias": "autofocusFilter"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "emptyFilterMessage": { "alias": "emptyFilterMessage"; "required": false; "isSignal": true; }; "showClear": { "alias": "showClear"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "loadingIcon": { "alias": "loadingIcon"; "required": false; "isSignal": true; }; "dropdownIcon": { "alias": "dropdownIcon"; "required": false; "isSignal": true; }; "clearIcon": { "alias": "clearIcon"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "styleClass": { "alias": "styleClass"; "required": false; "isSignal": true; }; "style": { "alias": "style"; "required": false; "isSignal": true; }; "appendTo": { "alias": "appendTo"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "checkmark": { "alias": "checkmark"; "required": false; "isSignal": true; }; "group": { "alias": "group"; "required": false; "isSignal": true; }; "optionGroupLabel": { "alias": "optionGroupLabel"; "required": false; "isSignal": true; }; "optionGroupChildren": { "alias": "optionGroupChildren"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualScrollItemSize": { "alias": "virtualScrollItemSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "selectedObject": { "alias": "selectedObject"; "required": false; "isSignal": true; }; }, { "onFilter": "onFilter"; "onChange": "onChange"; "onShow": "onShow"; "onHide": "onHide"; "onBlur": "onBlur"; "onFocus": "onFocus"; "onClear": "onClear"; "onLazyLoad": "onLazyLoad"; }, ["selectedItemRef", "itemRef", "groupRef", "headerRef", "footerRef", "emptyRef", "emptyFilterRef", "loaderRef", "filterRef", "fTemplates"], never, true, never>;
 }
 
 type FMultiSelectFilterMatchMode = 'contains' | 'startsWith' | 'endsWith' | 'equals' | 'notEquals';
@@ -843,13 +855,9 @@ declare class MultiSelectComponent implements ControlValueAccessor {
     private readonly _triggerRef;
     private readonly _filterInputRef;
     private readonly _panelRef;
-    private readonly _panelTop;
-    private readonly _panelLeft;
-    private readonly _panelWidth;
+    private readonly _placement;
     readonly panelClass: _angular_core.Signal<string>;
     readonly panelStyle: _angular_core.Signal<Record<string, string>>;
-    private position;
-    private adjustForViewport;
     readonly triggerClass: _angular_core.Signal<string>;
     readonly options: _angular_core.InputSignal<unknown[]>;
     readonly optionLabel: _angular_core.InputSignal<string>;
@@ -889,6 +897,13 @@ declare class MultiSelectComponent implements ControlValueAccessor {
     readonly virtualScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly virtualScrollItemSize: _angular_core.InputSignal<number>;
     readonly lazy: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Full option objects for the currently selected `values()`, supplied by the
+     * consumer. Pinned into the option pool (deduped by `optionValue`) whenever a
+     * lazy-loaded or filtered `options()` page doesn't contain one of them, so
+     * chips/labels always resolve correctly on edit forms.
+     */
+    readonly selectedObjects: _angular_core.InputSignal<unknown[]>;
     readonly hostClass: _angular_core.Signal<string>;
     readonly onBlur: _angular_core.OutputEmitterRef<void>;
     readonly onFocus: _angular_core.OutputEmitterRef<FocusEvent>;
@@ -939,6 +954,9 @@ declare class MultiSelectComponent implements ControlValueAccessor {
     readonly filterFieldList: _angular_core.Signal<string[]>;
     private matchesFilter;
     private optionMatchesQuery;
+    private readonly selectedObjectEntries;
+    private mergeSelected;
+    readonly optionsWithSelected: _angular_core.Signal<unknown[]>;
     readonly filteredOptions: _angular_core.Signal<unknown[]>;
     readonly allLeafOptions: _angular_core.Signal<unknown[]>;
     readonly flatItems: _angular_core.Signal<FMultiSelectFlatItem[]>;
@@ -973,7 +991,7 @@ declare class MultiSelectComponent implements ControlValueAccessor {
     registerOnTouched(fn: () => void): void;
     setDisabledState(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "f-multiselect", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionLabel": { "alias": "optionLabel"; "required": false; "isSignal": true; }; "optionValue": { "alias": "optionValue"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "filterBy": { "alias": "filterBy"; "required": false; "isSignal": true; }; "filterMatchMode": { "alias": "filterMatchMode"; "required": false; "isSignal": true; }; "filterLocale": { "alias": "filterLocale"; "required": false; "isSignal": true; }; "filterPlaceholder": { "alias": "filterPlaceholder"; "required": false; "isSignal": true; }; "resetFilterOnHide": { "alias": "resetFilterOnHide"; "required": false; "isSignal": true; }; "autofocusFilter": { "alias": "autofocusFilter"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "emptyFilterMessage": { "alias": "emptyFilterMessage"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "showClear": { "alias": "showClear"; "required": false; "isSignal": true; }; "optionDisabled": { "alias": "optionDisabled"; "required": false; "isSignal": true; }; "display": { "alias": "display"; "required": false; "isSignal": true; }; "maxSelectedLabels": { "alias": "maxSelectedLabels"; "required": false; "isSignal": true; }; "selectionLimit": { "alias": "selectionLimit"; "required": false; "isSignal": true; }; "showToggleAll": { "alias": "showToggleAll"; "required": false; "isSignal": true; }; "styleClass": { "alias": "styleClass"; "required": false; "isSignal": true; }; "style": { "alias": "style"; "required": false; "isSignal": true; }; "appendTo": { "alias": "appendTo"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "loadingIcon": { "alias": "loadingIcon"; "required": false; "isSignal": true; }; "dropdownIcon": { "alias": "dropdownIcon"; "required": false; "isSignal": true; }; "clearIcon": { "alias": "clearIcon"; "required": false; "isSignal": true; }; "group": { "alias": "group"; "required": false; "isSignal": true; }; "optionGroupLabel": { "alias": "optionGroupLabel"; "required": false; "isSignal": true; }; "optionGroupChildren": { "alias": "optionGroupChildren"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualScrollItemSize": { "alias": "virtualScrollItemSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; }, { "onBlur": "onBlur"; "onFocus": "onFocus"; "onChange": "onChange"; "onFilter": "onFilter"; "onShow": "onShow"; "onHide": "onHide"; "onClear": "onClear"; "onLazyLoad": "onLazyLoad"; "onSelectAllChange": "onSelectAllChange"; }, ["selectedItemRef", "itemRef", "groupRef", "headerRef", "footerRef", "emptyRef", "emptyFilterRef", "loaderRef", "filterRef", "fTemplates"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "f-multiselect", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionLabel": { "alias": "optionLabel"; "required": false; "isSignal": true; }; "optionValue": { "alias": "optionValue"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "filterBy": { "alias": "filterBy"; "required": false; "isSignal": true; }; "filterMatchMode": { "alias": "filterMatchMode"; "required": false; "isSignal": true; }; "filterLocale": { "alias": "filterLocale"; "required": false; "isSignal": true; }; "filterPlaceholder": { "alias": "filterPlaceholder"; "required": false; "isSignal": true; }; "resetFilterOnHide": { "alias": "resetFilterOnHide"; "required": false; "isSignal": true; }; "autofocusFilter": { "alias": "autofocusFilter"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "emptyFilterMessage": { "alias": "emptyFilterMessage"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "showClear": { "alias": "showClear"; "required": false; "isSignal": true; }; "optionDisabled": { "alias": "optionDisabled"; "required": false; "isSignal": true; }; "display": { "alias": "display"; "required": false; "isSignal": true; }; "maxSelectedLabels": { "alias": "maxSelectedLabels"; "required": false; "isSignal": true; }; "selectionLimit": { "alias": "selectionLimit"; "required": false; "isSignal": true; }; "showToggleAll": { "alias": "showToggleAll"; "required": false; "isSignal": true; }; "styleClass": { "alias": "styleClass"; "required": false; "isSignal": true; }; "style": { "alias": "style"; "required": false; "isSignal": true; }; "appendTo": { "alias": "appendTo"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "loadingIcon": { "alias": "loadingIcon"; "required": false; "isSignal": true; }; "dropdownIcon": { "alias": "dropdownIcon"; "required": false; "isSignal": true; }; "clearIcon": { "alias": "clearIcon"; "required": false; "isSignal": true; }; "group": { "alias": "group"; "required": false; "isSignal": true; }; "optionGroupLabel": { "alias": "optionGroupLabel"; "required": false; "isSignal": true; }; "optionGroupChildren": { "alias": "optionGroupChildren"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualScrollItemSize": { "alias": "virtualScrollItemSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "selectedObjects": { "alias": "selectedObjects"; "required": false; "isSignal": true; }; }, { "onBlur": "onBlur"; "onFocus": "onFocus"; "onChange": "onChange"; "onFilter": "onFilter"; "onShow": "onShow"; "onHide": "onHide"; "onClear": "onClear"; "onLazyLoad": "onLazyLoad"; "onSelectAllChange": "onSelectAllChange"; }, ["selectedItemRef", "itemRef", "groupRef", "headerRef", "footerRef", "emptyRef", "emptyFilterRef", "loaderRef", "filterRef", "fTemplates"], never, true, never>;
 }
 
 interface CheckboxChangeEvent {
@@ -1603,7 +1621,7 @@ declare class FileUploadComponent implements OnDestroy {
 type DialogPosition = 'center' | 'top' | 'bottom' | 'left' | 'right' | 'topleft' | 'topright' | 'bottomleft' | 'bottomright';
 declare class DialogComponent {
     private static idCounter;
-    private readonly _doc;
+    private readonly _overlayStack;
     protected readonly headerId: string;
     readonly header: _angular_core.InputSignal<string>;
     readonly visible: _angular_core.ModelSignal<boolean>;
@@ -1643,8 +1661,11 @@ declare class DialogComponent {
     readonly rendered: _angular_core.Signal<boolean>;
     private readonly _closing;
     readonly closing: _angular_core.Signal<boolean>;
+    private readonly _zIndex;
+    readonly zIndex: _angular_core.Signal<number | null>;
     private readonly panelRef;
     private _previouslyFocused;
+    private _scrollLocked;
     constructor();
     onEscape(): void;
     close(): void;
@@ -1662,7 +1683,7 @@ declare class DialogComponent {
 type DrawerPosition = 'left' | 'right' | 'top' | 'bottom' | 'full';
 declare class DrawerComponent {
     private static idCounter;
-    private readonly _doc;
+    private readonly _overlayStack;
     protected readonly headerId: string;
     readonly header: _angular_core.InputSignal<string>;
     readonly visible: _angular_core.ModelSignal<boolean>;
@@ -1691,8 +1712,11 @@ declare class DrawerComponent {
     readonly rendered: _angular_core.Signal<boolean>;
     private readonly _closing;
     readonly closing: _angular_core.Signal<boolean>;
+    private readonly _zIndex;
+    readonly zIndex: _angular_core.Signal<number | null>;
     private readonly panelRef;
     private _previouslyFocused;
+    private _scrollLocked;
     constructor();
     onEscape(): void;
     close(): void;
@@ -1721,11 +1745,11 @@ declare class PopoverComponent {
     readonly onHide: _angular_core.OutputEmitterRef<void>;
     private readonly _visible;
     readonly visible: _angular_core.Signal<boolean>;
-    private readonly _top;
+    private readonly panelRef;
+    private readonly _placement;
     readonly top: _angular_core.Signal<number>;
-    private readonly _left;
     readonly left: _angular_core.Signal<number>;
-    private readonly panelRef;
+    readonly maxHeight: _angular_core.Signal<number | null>;
     private _anchor;
     private _previouslyFocused;
     private readonly _windowWidth;
@@ -1738,8 +1762,6 @@ declare class PopoverComponent {
     private showInternal;
     hide(): void;
     private focusPanel;
-    private position;
-    private adjustForViewport;
     onCloseIconClick(event: Event): void;
     onEscape(): void;
     onDocumentClick(e: Event): void;
@@ -2423,15 +2445,10 @@ declare class AutoCompleteComponent implements ControlValueAccessor {
     readonly listboxId: string;
     private readonly anchorRef;
     private readonly panelRef;
-    private readonly _panelTop;
-    private readonly _panelLeft;
-    private readonly _panelWidth;
+    private readonly _placement;
     readonly panelClass: _angular_core.Signal<string>;
     readonly panelStyle: _angular_core.Signal<Record<string, string>>;
-    private position;
-    private adjustForViewport;
     private openPanel;
-    constructor();
     onDocumentClick(e: MouseEvent): void;
     readonly suggestions: _angular_core.InputSignal<unknown[]>;
     readonly field: _angular_core.InputSignal<string>;
@@ -2686,11 +2703,10 @@ declare class SplitButtonComponent {
     readonly onHide: _angular_core.OutputEmitterRef<void>;
     private readonly _open;
     readonly open: _angular_core.Signal<boolean>;
-    private readonly _menuTop;
-    private readonly _menuLeft;
+    private readonly _placement;
     readonly menuTop: _angular_core.Signal<number>;
     readonly menuLeft: _angular_core.Signal<number>;
-    constructor();
+    readonly menuMaxHeight: _angular_core.Signal<number | null>;
     readonly groupClass: _angular_core.Signal<string>;
     readonly dropdownClass: _angular_core.Signal<string>;
     readonly menuPanelClass: _angular_core.Signal<string>;
@@ -2703,8 +2719,6 @@ declare class SplitButtonComponent {
     private close;
     private menuItems;
     private focusItem;
-    private positionMenu;
-    private adjustMenuForViewport;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SplitButtonComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SplitButtonComponent, "f-splitbutton", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "model": { "alias": "model"; "required": false; "isSignal": true; }; "severity": { "alias": "severity"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "raised": { "alias": "raised"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; "outlined": { "alias": "outlined"; "required": false; "isSignal": true; }; "text": { "alias": "text"; "required": false; "isSignal": true; }; "iconPos": { "alias": "iconPos"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "menuStyleClass": { "alias": "menuStyleClass"; "required": false; "isSignal": true; }; "appendTo": { "alias": "appendTo"; "required": false; "isSignal": true; }; "dropdownIcon": { "alias": "dropdownIcon"; "required": false; "isSignal": true; }; "expandAriaLabel": { "alias": "expandAriaLabel"; "required": false; "isSignal": true; }; }, { "onClick": "onClick"; "onDropdownClick": "onDropdownClick"; "onShow": "onShow"; "onHide": "onHide"; }, never, never, true, never>;
 }
@@ -2878,7 +2892,6 @@ interface FlatTreeSelectNode {
 }
 declare class TreeSelectComponent implements ControlValueAccessor {
     private readonly _el;
-    constructor();
     readonly options: _angular_core.InputSignal<TreeNode<unknown>[]>;
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -2900,13 +2913,9 @@ declare class TreeSelectComponent implements ControlValueAccessor {
     readonly hostClass: _angular_core.Signal<string>;
     private readonly triggerRef;
     private readonly panelRef;
-    private readonly _panelTop;
-    private readonly _panelLeft;
-    private readonly _panelWidth;
+    private readonly _placement;
     readonly panelClass: _angular_core.Signal<string>;
     readonly panelStyle: _angular_core.Signal<Record<string, string>>;
-    private position;
-    private adjustForViewport;
     private readonly _open;
     readonly open: _angular_core.Signal<boolean>;
     private readonly _filterText;
@@ -3115,11 +3124,9 @@ declare class MenuComponent {
     readonly onHide: _angular_core.OutputEmitterRef<void>;
     private readonly _visible;
     readonly visible: _angular_core.Signal<boolean>;
-    private readonly _top;
-    private readonly _left;
+    private readonly _placement;
     private _openedAt;
     private _anchor;
-    constructor();
     readonly fTemplates: _angular_core.Signal<readonly FTemplateDirective[]>;
     private namedTemplate;
     readonly itemTpl: _angular_core.Signal<TemplateRef<unknown> | null>;
@@ -3131,8 +3138,6 @@ declare class MenuComponent {
     toggle(event?: Event): void;
     show(event?: Event): void;
     hide(): void;
-    private position;
-    private adjustForViewport;
     onDocumentClick(e: MouseEvent): void;
     onItemClick(e: Event, item: MenuItem): void;
     onKeydown(e: KeyboardEvent): void;
@@ -3190,9 +3195,8 @@ declare class TieredMenuComponent {
     readonly onHide: _angular_core.OutputEmitterRef<void>;
     private readonly _visible;
     readonly visible: _angular_core.Signal<boolean>;
-    private readonly _top;
+    private readonly _placement;
     readonly top: _angular_core.Signal<number>;
-    private readonly _left;
     readonly left: _angular_core.Signal<number>;
     private _openedAt;
     private _anchor;
@@ -3208,8 +3212,6 @@ declare class TieredMenuComponent {
     toggle(event?: Event): void;
     show(event?: Event): void;
     hide(): void;
-    private position;
-    private adjustForViewport;
     isItemActive(item: MenuItem, level: number): boolean;
     itemsAtLevel(level: number): MenuItem[];
     onItemMouseEnter(event: MouseEvent, item: MenuItem, level: number): void;
@@ -3275,7 +3277,7 @@ declare class MegaMenuComponent {
     private readonly _activeItem;
     readonly activeItem: _angular_core.Signal<MenuItem | null>;
     private readonly _panelAlign;
-    readonly panelAlign: _angular_core.Signal<"end" | "start">;
+    readonly panelAlign: _angular_core.Signal<"start" | "end">;
     private readonly _mobileOpen;
     readonly mobileOpen: _angular_core.Signal<boolean>;
     private readonly _mobileExpanded;
@@ -3359,7 +3361,10 @@ declare class SpeedDialComponent {
     readonly onHide: _angular_core.OutputEmitterRef<void>;
     readonly onVisibleChange: _angular_core.OutputEmitterRef<boolean>;
     private readonly _el;
+    private readonly _overlayStack;
     private readonly _toggleBtn;
+    private readonly _maskZIndex;
+    readonly maskZIndex: _angular_core.Signal<number | null>;
     readonly hostClass: _angular_core.Signal<string>;
     readonly effectiveRadius: _angular_core.Signal<number>;
     readonly buttonIcon: _angular_core.Signal<string>;
@@ -3573,7 +3578,6 @@ interface CascadeOption {
 }
 declare class CascadeSelectComponent implements ControlValueAccessor {
     private readonly _el;
-    constructor();
     readonly options: _angular_core.InputSignal<CascadeOption[]>;
     readonly optionLabel: _angular_core.InputSignal<string>;
     readonly optionValue: _angular_core.InputSignal<string>;
@@ -3593,12 +3597,9 @@ declare class CascadeSelectComponent implements ControlValueAccessor {
     readonly hostClass: _angular_core.Signal<string>;
     private readonly triggerRef;
     private readonly panelRef;
-    private readonly _panelTop;
-    private readonly _panelLeft;
+    private readonly _placement;
     readonly panelClass: _angular_core.Signal<string>;
     readonly panelStyle: _angular_core.Signal<Record<string, string>>;
-    private position;
-    private adjustForViewport;
     private readonly _open;
     readonly open: _angular_core.Signal<boolean>;
     private readonly _activePath;
@@ -3667,6 +3668,7 @@ declare class ConfirmPopupComponent {
     protected readonly headerId: string;
     protected readonly descId: string;
     readonly confirmationService: ConfirmationService;
+    private readonly _overlayStack;
     readonly key: _angular_core.InputSignal<string | undefined>;
     readonly acceptLabel: _angular_core.InputSignal<string>;
     readonly rejectLabel: _angular_core.InputSignal<string>;
@@ -3679,10 +3681,11 @@ declare class ConfirmPopupComponent {
     readonly dismissable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly styleClass: _angular_core.InputSignal<string>;
     readonly style: _angular_core.InputSignal<Record<string, string> | null>;
-    private readonly _top;
+    private readonly _placement;
     readonly top: _angular_core.Signal<number>;
-    private readonly _left;
     readonly left: _angular_core.Signal<number>;
+    private readonly _zIndex;
+    readonly zIndex: _angular_core.Signal<number | null>;
     private readonly panelRef;
     readonly activeConfirmation: _angular_core.Signal<UiConfirmation | null>;
     constructor();
@@ -3701,8 +3704,6 @@ declare class ConfirmPopupComponent {
     resolvedRejectIcon(c: {
         rejectIcon?: string;
     }): string;
-    private position;
-    private adjustForViewport;
     onEscape(): void;
     accept(fn?: () => void): void;
     reject(fn?: () => void): void;
@@ -3731,6 +3732,7 @@ declare class DynamicDialogRef<R = unknown> {
     private readonly _closeFn;
     private readonly _onClose;
     readonly onClose: rxjs.Observable<R | undefined>;
+    private _closed;
     constructor(_closeFn: (result?: R) => void);
     close(result?: R): void;
 }
@@ -3741,9 +3743,11 @@ interface DynamicDialogState {
     component: Type<unknown>;
     config: DynamicDialogConfig;
     ref: DynamicDialogRef<unknown>;
+    zIndex: number;
 }
 declare class DynamicDialogService {
     private static idCounter;
+    private readonly _overlayStack;
     private readonly _states;
     readonly states: _angular_core.Signal<DynamicDialogState[]>;
     open<T = unknown, R = unknown>(component: Type<T>, config?: DynamicDialogConfig): DynamicDialogRef<R>;
@@ -3755,7 +3759,6 @@ declare class DynamicDialogService {
 declare class DynamicDialogComponent {
     readonly dialogService: DynamicDialogService;
     private readonly _parentInjector;
-    private readonly _doc;
     private readonly injectorCache;
     constructor();
     childInjector(state: DynamicDialogState): Injector;
@@ -4434,15 +4437,94 @@ declare class RippleDirective {
 type UiIconSeverity = 'success' | 'info' | 'warn' | 'danger' | 'secondary' | 'contrast' | null;
 declare class UiIconComponent {
     readonly name: _angular_core.InputSignal<string>;
-    readonly size: _angular_core.InputSignal<number>;
+    readonly size: _angular_core.InputSignal<number | undefined>;
     readonly spin: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly fill: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly severity: _angular_core.InputSignal<UiIconSeverity>;
+    readonly resolvedSize: _angular_core.Signal<string | number>;
     readonly lucideName: _angular_core.Signal<string>;
     readonly iconClass: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<UiIconComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<UiIconComponent, "ui-icon", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "spin": { "alias": "spin"; "required": false; "isSignal": true; }; "fill": { "alias": "fill"; "required": false; "isSignal": true; }; "severity": { "alias": "severity"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { AURA_PRESET, AccordionComponent, AccordionContentComponent, AccordionContext, AccordionHeaderComponent, AccordionPanelComponent, AnimateOnScrollDirective, AutoCompleteComponent, AutoFocusDirective, AvatarComponent, AvatarGroupComponent, BadgeComponent, BlockUiComponent, BreadcrumbComponent, ButtonComponent, ButtonGroupComponent, CardComponent, CarouselComponent, CascadeSelectComponent, ChartComponent, CheckboxComponent, ChipComponent, ColorPickerComponent, ConfirmDialog, ConfirmPopupComponent, ConfirmationService, ContextMenuComponent, DYNAMIC_DIALOG_DATA, DYNAMIC_DIALOG_REF, DataViewComponent, DatePickerComponent, DialogComponent, DividerComponent, DockComponent, DrawerComponent, DynamicDialogComponent, DynamicDialogRef, DynamicDialogService, EditorComponent, FButtonDirective, FTemplateDirective, FieldsetComponent, FileUploadComponent, FloatLabelComponent, FluidComponent, GalleriaComponent, IconFieldComponent, IftaLabelComponent, ImageCompareComponent, ImageComponent, InplaceComponent, InputGroupAddonComponent, InputGroupComponent, InputIconComponent, InputMaskDirective, InputNumberComponent, InputOtpComponent, InputPasswordDirective, InputTextDirective, KeyFilterDirective, KnobComponent, LARA_PRESET, ListboxComponent, MegaMenuComponent, MenuComponent, MenubarComponent, MessageComponent, MessageService, MeterGroupComponent, MultiSelectComponent, NOIR_PRIMARY, NORA_PRESET, NgUIConfig, OrderListComponent, OrganizationChartComponent, OverlayBadgeComponent, PRESETS, PRESET_NAMES, PRIMARY_PALETTES, PaginatorComponent, PanelComponent, PanelMenuComponent, PasswordComponent, PickListComponent, PopoverComponent, ProgressSpinnerComponent, ProgressbarComponent, RadioButtonComponent, RatingComponent, RippleDirective, SURFACE_PALETTES, ScrollPanelComponent, ScrollTopComponent, ScrollerComponent, SelectButtonComponent, SelectComponent, SkeletonComponent, SliderComponent, SortIconComponent, SortableColumnDirective, SpeedDialComponent, SplitButtonComponent, SplitterComponent, SplitterPanelComponent, StepsComponent, StyleClassDirective, TabComponent, TabListComponent, TabPanelComponent, TabPanelsComponent, TableComponent, TabsComponent, TabsContext, TagComponent, TerminalComponent, TextareaDirective, TieredMenuComponent, TimelineComponent, ToastComponent, ToggleButtonComponent, ToggleSwitchComponent, ToolbarComponent, TooltipDirective, TreeComponent, TreeSelectComponent, TreeTableComponent, TreeTableService, TreeTableTogglerComponent, UiIconComponent, applyDarkSemantics, applyLightSemantics, applyPreset, applyPrimaryPalette, applySurfacePalette, applyTheme, buildBootstrapPreset, provideNgUI };
-export type { ApplyThemeOptions, AutoCompleteCompleteEvent, AutoCompleteSelectEvent, BadgeSeverity, BadgeSize, ButtonSeverity, CheckboxChangeEvent, ColorFormat, ColorPalette, ColorPickerChangeEvent, DataViewLayout, DialogPosition, DrawerPosition, DynamicDialogConfig, FileRemoveEvent, FileSelectEvent, FloatLabelVariant, GalleriaItem, KeyFilterPreset, ListboxChangeEvent, MenuItem, MenuItemCommandEvent, MeterItem, NgUIOptions, NgUITranslationConfig, PaginatorState, PresetName, ProvideNgUIOptions, RadioButtonClickEvent, SelectButtonTokens, SpeedDialDirection, SpeedDialType, StepsMenuItem, SurfacePalette, TableLazyLoadEvent, TerminalCommandEvent, ThemePreset, TimelineAlign, TimelineLayout, TreeSelectionMode as TreeComponentSelectionMode, TreeNode, TreeSelectionMode$1 as TreeSelectionMode, TreeTableNode, UiMessage };
+declare class OverlayStackService {
+    private readonly _doc;
+    private nextZIndex;
+    private lockCount;
+    open(): number;
+    lockScroll(): void;
+    unlockScroll(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<OverlayStackService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<OverlayStackService>;
+}
+
+type OverlayAlign = 'start' | 'end';
+type OverlayDirection = 'down' | 'up';
+interface OverlayRect {
+    top: number;
+    left: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+}
+interface OverlaySize {
+    width: number;
+    height: number;
+}
+interface OverlayPositionOptions {
+    /** Distance between the anchor and the panel. */
+    gap?: number;
+    /** Minimum distance kept between the panel and every viewport edge. */
+    margin?: number;
+    /** `start` aligns the left edges to the anchor, `end` the right edges. */
+    align?: OverlayAlign;
+    /** Force the panel to the anchor's width (trigger-style dropdowns). */
+    matchAnchorWidth?: boolean;
+    /** Never clamp the panel below this, even when the viewport is tiny. */
+    minHeight?: number;
+    /**
+     * Set to false for overlays whose children escape their box (flyout submenus
+     * need `overflow: visible`, so a `max-height` would cut them off instead).
+     */
+    clampHeight?: boolean;
+}
+interface OverlayPlacement {
+    top: number;
+    left: number;
+    /** `null` when the panel keeps its own width. */
+    width: number | null;
+    /** `null` when `clampHeight` is disabled. */
+    maxHeight: number | null;
+    direction: OverlayDirection;
+}
+/**
+ * Places a panel against an anchor inside the viewport: flips above the anchor
+ * when there is more room there, clamps horizontally, and hands back a
+ * `maxHeight` when the panel would otherwise be cut off by a viewport edge, so
+ * it scrolls internally instead.
+ */
+declare function computeOverlayPlacement(anchor: OverlayRect, panel: OverlaySize, viewport: OverlaySize, options?: OverlayPositionOptions): OverlayPlacement;
+declare function overlayPlacementStyle(placement: OverlayPlacement | null): Record<string, string>;
+interface OverlayPositionConfig {
+    /** Positions (and listens) only while this is true. */
+    active: () => boolean;
+    anchor: () => HTMLElement | null | undefined;
+    panel: () => HTMLElement | null | undefined;
+    options?: () => OverlayPositionOptions;
+}
+/**
+ * Signal-based placement for components that render their panel from a
+ * template. Bind the result through `overlayPlacementStyle()`. Must be called
+ * in an injection context.
+ */
+declare function overlayPosition(config: OverlayPositionConfig): Signal<OverlayPlacement | null>;
+/**
+ * Imperative twin of `overlayPosition()` for overlays that portal a plain DOM
+ * node instead of rendering a template. Returns a dispose function.
+ */
+declare function attachOverlayPosition(anchor: HTMLElement, panel: HTMLElement, options?: OverlayPositionOptions): () => void;
+
+export { AURA_PRESET, AccordionComponent, AccordionContentComponent, AccordionContext, AccordionHeaderComponent, AccordionPanelComponent, AnimateOnScrollDirective, AutoCompleteComponent, AutoFocusDirective, AvatarComponent, AvatarGroupComponent, BadgeComponent, BlockUiComponent, BreadcrumbComponent, ButtonComponent, ButtonGroupComponent, CardComponent, CarouselComponent, CascadeSelectComponent, ChartComponent, CheckboxComponent, ChipComponent, ColorPickerComponent, ConfirmDialog, ConfirmPopupComponent, ConfirmationService, ContextMenuComponent, DYNAMIC_DIALOG_DATA, DYNAMIC_DIALOG_REF, DataViewComponent, DatePickerComponent, DialogComponent, DividerComponent, DockComponent, DrawerComponent, DynamicDialogComponent, DynamicDialogRef, DynamicDialogService, EditorComponent, FButtonDirective, FTemplateDirective, FieldsetComponent, FileUploadComponent, FloatLabelComponent, FluidComponent, GalleriaComponent, IconFieldComponent, IftaLabelComponent, ImageCompareComponent, ImageComponent, InplaceComponent, InputGroupAddonComponent, InputGroupComponent, InputIconComponent, InputMaskDirective, InputNumberComponent, InputOtpComponent, InputPasswordDirective, InputTextDirective, KeyFilterDirective, KnobComponent, LARA_PRESET, ListboxComponent, MegaMenuComponent, MenuComponent, MenubarComponent, MessageComponent, MessageService, MeterGroupComponent, MultiSelectComponent, NOIR_PRIMARY, NORA_PRESET, NgUIConfig, OrderListComponent, OrganizationChartComponent, OverlayBadgeComponent, OverlayStackService, PRESETS, PRESET_NAMES, PRIMARY_PALETTES, PaginatorComponent, PanelComponent, PanelMenuComponent, PasswordComponent, PickListComponent, PopoverComponent, ProgressSpinnerComponent, ProgressbarComponent, RadioButtonComponent, RatingComponent, RippleDirective, SURFACE_PALETTES, ScrollPanelComponent, ScrollTopComponent, ScrollerComponent, SelectButtonComponent, SelectComponent, SkeletonComponent, SliderComponent, SortIconComponent, SortableColumnDirective, SpeedDialComponent, SplitButtonComponent, SplitterComponent, SplitterPanelComponent, StepsComponent, StyleClassDirective, TabComponent, TabListComponent, TabPanelComponent, TabPanelsComponent, TableComponent, TabsComponent, TabsContext, TagComponent, TerminalComponent, TextareaDirective, TieredMenuComponent, TimelineComponent, ToastComponent, ToggleButtonComponent, ToggleSwitchComponent, ToolbarComponent, TooltipDirective, TreeComponent, TreeSelectComponent, TreeTableComponent, TreeTableService, TreeTableTogglerComponent, UiIconComponent, applyDarkSemantics, applyLightSemantics, applyPreset, applyPrimaryPalette, applySurfacePalette, applyTheme, attachOverlayPosition, buildBootstrapPreset, computeOverlayPlacement, overlayPlacementStyle, overlayPosition, provideNgUI };
+export type { ApplyThemeOptions, AutoCompleteCompleteEvent, AutoCompleteSelectEvent, BadgeSeverity, BadgeSize, ButtonSeverity, CheckboxChangeEvent, ColorFormat, ColorPalette, ColorPickerChangeEvent, DataViewLayout, DialogPosition, DrawerPosition, DynamicDialogConfig, FileRemoveEvent, FileSelectEvent, FloatLabelVariant, GalleriaItem, KeyFilterPreset, ListboxChangeEvent, MenuItem, MenuItemCommandEvent, MeterItem, NgUIOptions, NgUITranslationConfig, OverlayAlign, OverlayDirection, OverlayPlacement, OverlayPositionConfig, OverlayPositionOptions, PaginatorState, PresetName, ProvideNgUIOptions, RadioButtonClickEvent, SelectButtonTokens, SpeedDialDirection, SpeedDialType, StepsMenuItem, SurfacePalette, TableLazyLoadEvent, TerminalCommandEvent, ThemePreset, TimelineAlign, TimelineLayout, TreeSelectionMode as TreeComponentSelectionMode, TreeNode, TreeSelectionMode$1 as TreeSelectionMode, TreeTableNode, UiMessage };