ps-helix 5.1.2 → 6.0.0

package/types/ps-helix.d.ts

@@ -4,7 +4,6 @@ import { ControlValueAccessor } from '@angular/forms';
 import { FormCheckboxControl, FormValueControl } from '@angular/forms/signals';
 import * as ps_helix from 'ps-helix';
 import { Observable } from 'rxjs';
-import { Router } from '@angular/router';
 
 /**
  * Types d'alertes disponibles
@@ -124,7 +123,7 @@ declare class PshAvatarComponent {
     hasIcon: _angular_core.Signal<boolean>;
     computedAriaLabel: _angular_core.Signal<string>;
     statusColor: _angular_core.Signal<string | undefined>;
-    state: _angular_core.Signal<AvatarStatus | "default">;
+    state: _angular_core.Signal<"default" | AvatarStatus>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PshAvatarComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PshAvatarComponent, "psh-avatar", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "src": { "alias": "src"; "required": false; "isSignal": true; }; "alt": { "alias": "alt"; "required": false; "isSignal": true; }; "initials": { "alias": "initials"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "size": "sizeChange"; "shape": "shapeChange"; "src": "srcChange"; "alt": "altChange"; }, never, never, true, never>;
 }
@@ -253,6 +252,7 @@ type CardActionsAlignment = 'left' | 'center' | 'right' | 'space-between';
  */
 declare class PshCardComponent implements OnDestroy {
     private platformId;
+    private readonly document;
     private resizeObserver?;
     isMobile: _angular_core.WritableSignal<boolean>;
     /** Variante visuelle de la carte (default, elevated, outlined) */
@@ -288,7 +288,7 @@ declare class PshCardComponent implements OnDestroy {
     /** État désactivé - réduit l'opacité */
     disabled: _angular_core.InputSignal<boolean>;
     /** Émis lors du clic sur la carte (si interactive) */
-    clicked: _angular_core.OutputEmitterRef<MouseEvent | KeyboardEvent>;
+    clicked: _angular_core.OutputEmitterRef<KeyboardEvent | MouseEvent>;
     /** Classes CSS calculées selon les propriétés */
     computedClasses: _angular_core.Signal<string>;
     /** Styles calculés */
@@ -356,7 +356,7 @@ declare class PshStatCardComponent {
     /** Active la direction row pour le card-body (icône et contenu côte à côte en flex-row) */
     rowDirection: _angular_core.InputSignal<boolean>;
     /** Émis lors du clic sur la carte */
-    clicked: _angular_core.OutputEmitterRef<MouseEvent | KeyboardEvent>;
+    clicked: _angular_core.OutputEmitterRef<KeyboardEvent | MouseEvent>;
     private computedValue;
     private computedDescription;
     private computedIcon;
@@ -450,7 +450,7 @@ declare class PshHorizontalCardComponent {
     /** Hauteur du contenu latéral sur mobile (utiliser les tokens de sizing) */
     mobileHeight: _angular_core.InputSignal<string>;
     /** Émis lors du clic sur la carte */
-    clicked: _angular_core.OutputEmitterRef<MouseEvent | KeyboardEvent>;
+    clicked: _angular_core.OutputEmitterRef<KeyboardEvent | MouseEvent>;
     /** Classes CSS calculées selon les propriétés */
     computedClasses: _angular_core.Signal<string>;
     /** Styles calculés */
@@ -560,7 +560,7 @@ declare class PshInfoCardComponent implements AfterContentInit, OnDestroy {
     /** Whether the card is disabled */
     disabled: _angular_core.InputSignal<boolean>;
     /** Emitted when card is clicked */
-    clicked: _angular_core.OutputEmitterRef<MouseEvent | KeyboardEvent>;
+    clicked: _angular_core.OutputEmitterRef<KeyboardEvent | MouseEvent>;
     /** Whether to show copy buttons on rows (opt-in) */
     copyable: _angular_core.InputSignal<boolean>;
     /** Label prefix for the copy button aria-label */
@@ -578,6 +578,7 @@ declare class PshInfoCardComponent implements AfterContentInit, OnDestroy {
     /** Signal to track if viewport is mobile */
     isMobile: _angular_core.WritableSignal<boolean>;
     private platformId;
+    private readonly document;
     private resizeObserver?;
     private feedbackTimeout?;
     /** Determines if the empty state should be shown */
@@ -671,6 +672,7 @@ declare class PshCheckboxComponent implements ControlValueAccessor, FormCheckbox
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     focus(): void;
+    blur(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PshCheckboxComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PshCheckboxComponent, "psh-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "labelPosition": { "alias": "labelPosition"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "disabled": "disabledChange"; "indeterminate": "indeterminateChange"; "touched": "touchedChange"; }, never, ["*"], true, never>;
 }
@@ -761,9 +763,40 @@ interface DropdownConfig {
     iconOnlyText?: string;
 }
 
-declare class PshDropdownComponent<T = string> implements OnDestroy {
+/**
+ * Emits when a click occurs outside the host element.
+ *
+ * Shared primitive replacing the per-component document click listeners used by
+ * select / dropdown to close on outside click. Typically consumed as a host
+ * directive:
+ *
+ * @example
+ * ```typescript
+ * @Component({ hostDirectives: [PshClickOutsideDirective] })
+ * export class MyPopover {
+ *   constructor() {
+ *     inject(PshClickOutsideDirective).pshClickOutside.subscribe(() => this.close());
+ *   }
+ * }
+ * ```
+ */
+declare class PshClickOutsideDirective {
+    private readonly host;
+    private readonly document;
+    private readonly isBrowser;
+    /** Emitted when a click lands outside the host element. */
+    readonly pshClickOutside: _angular_core.OutputEmitterRef<MouseEvent>;
+    constructor();
+    private readonly onDocumentClick;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PshClickOutsideDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PshClickOutsideDirective, "[pshClickOutside]", never, {}, { "pshClickOutside": "pshClickOutside"; }, never, never, true, never>;
+}
+
+declare class PshDropdownComponent<T = string> {
     private elementRef;
-    private clickOutsideHandler;
+    private readonly isBrowser;
+    private readonly overlayPosition;
+    private readonly injector;
     appearance: _angular_core.InputSignal<DropdownAppearance>;
     variant: _angular_core.InputSignal<DropdownVariant>;
     size: _angular_core.InputSignal<DropdownSize>;
@@ -778,6 +811,7 @@ declare class PshDropdownComponent<T = string> implements OnDestroy {
     private isOpenSignal;
     private selectedItemSignal;
     private focusedItemIndex;
+    protected readonly resolvedPlacement: _angular_core.WritableSignal<DropdownPlacement>;
     selected: _angular_core.OutputEmitterRef<DropdownItem<T>>;
     opened: _angular_core.OutputEmitterRef<void>;
     closed: _angular_core.OutputEmitterRef<void>;
@@ -788,20 +822,19 @@ declare class PshDropdownComponent<T = string> implements OnDestroy {
     state: _angular_core.Signal<string>;
     private getState;
     constructor();
-    private setupClickOutsideListener;
+    private reposition;
     toggleDropdown(): void;
     selectItem(item: DropdownItem<T>): void;
     close(): void;
     handleTriggerKeyDown(event: KeyboardEvent): void;
-    handleItemKeyDown(event: KeyboardEvent, item: DropdownItem<T>, index: number): void;
+    handleItemKeyDown(event: KeyboardEvent, item: DropdownItem<T>, _index: number): void;
     private focusNextItem;
     private focusPreviousItem;
     private focusFirstItem;
     private focusLastItem;
     private focusItemAtIndex;
-    ngOnDestroy(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PshDropdownComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PshDropdownComponent<any>, "psh-dropdown", never, { "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "iconOnly": { "alias": "iconOnly"; "required": false; "isSignal": true; }; "iconOnlyText": { "alias": "iconOnlyText"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "disabled": "disabledChange"; "selected": "selected"; "opened": "opened"; "closed": "closed"; }, never, ["[dropdown-trigger]", "[dropdown-menu]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PshDropdownComponent<any>, "psh-dropdown", never, { "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "iconOnly": { "alias": "iconOnly"; "required": false; "isSignal": true; }; "iconOnlyText": { "alias": "iconOnlyText"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "disabled": "disabledChange"; "selected": "selected"; "opened": "opened"; "closed": "closed"; }, never, ["[dropdown-trigger]", "[dropdown-menu]"], true, [{ directive: typeof PshClickOutsideDirective; inputs: {}; outputs: {}; }]>;
 }
 
 type InputType = 'text' | 'password' | 'email' | 'tel' | 'url' | 'search' | 'date' | 'number';
@@ -973,7 +1006,7 @@ declare class PshTextareaComponent implements ControlValueAccessor, FormValueCon
     hasError: _angular_core.Signal<boolean>;
     computedAriaLabel: _angular_core.Signal<string | null>;
     describedBy: _angular_core.Signal<string | null>;
-    state: _angular_core.Signal<"success" | "default" | "disabled" | "error" | "readonly" | "focused">;
+    state: _angular_core.Signal<"default" | "success" | "disabled" | "error" | "readonly" | "focused">;
     characterCountLabel: "caractères";
     constructor();
     private onChange;
@@ -1027,6 +1060,7 @@ interface MenuItem<T = string> {
 }
 
 declare class PshMenuComponent<T = string> {
+    private readonly document;
     mode: _angular_core.InputSignal<MenuMode>;
     variant: _angular_core.InputSignal<MenuVariant>;
     collapsible: _angular_core.InputSignal<boolean>;
@@ -1119,11 +1153,19 @@ declare const MODAL_CONFIG: InjectionToken<Partial<ModalConfig>>;
  */
 declare class ModalService {
     private config;
+    /**
+     * Ordered stack of open modal ids (insertion order = visual stacking order).
+     * The last entry is the topmost (most recently opened) modal.
+     */
     private modalsSignal;
     /**
      * Computed signal exposing the number of active modals
      */
     readonly activeModalsCount: _angular_core.Signal<number>;
+    /**
+     * Computed signal exposing the id of the topmost modal, or null if none are open
+     */
+    readonly topmostModalId: _angular_core.Signal<string | null | undefined>;
     /**
      * Returns the global modal configuration
      */
@@ -1133,12 +1175,12 @@ declare class ModalService {
      */
     generateId(): string;
     /**
-     * Registers a modal instance when it opens
+     * Registers a modal instance when it opens, pushing it onto the stack
      * @param id - Unique modal identifier
      */
     register(id: string): void;
     /**
-     * Unregisters a modal instance when it closes
+     * Unregisters a modal instance when it closes, removing it from the stack
      * @param id - Unique modal identifier
      */
     unregister(id: string): void;
@@ -1147,6 +1189,12 @@ declare class ModalService {
      * @param id - Unique modal identifier
      */
     isRegistered(id: string): boolean;
+    /**
+     * Checks if a modal is the topmost (most recently opened) open modal.
+     * Used to ensure Escape / backdrop only dismiss the modal on top of the stack.
+     * @param id - Unique modal identifier
+     */
+    isTopmost(id: string): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ModalService>;
 }
@@ -1173,10 +1221,15 @@ declare class ModalService {
 declare class PshModalComponent implements AfterViewInit, OnDestroy {
     private readonly config;
     private readonly modalService;
+    private readonly overlay;
     private readonly renderer;
     private readonly platformId;
+    private readonly document;
+    private readonly isBrowser;
     private readonly modalId;
-    private previousActiveElement;
+    private overlayHandle;
+    /** z-index assigned by the overlay stack while open (keeps stacked modals layered). */
+    protected readonly zIndex: _angular_core.WritableSignal<number | null>;
     private modalElement?;
     private isAttachedToBody;
     private resizeListener?;
@@ -1266,10 +1319,6 @@ declare class PshModalComponent implements AfterViewInit, OnDestroy {
      * Keyboard event handler for Escape key
      */
     private readonly escapeHandler;
-    /**
-     * Keyboard event handler for focus trap
-     */
-    private readonly focusTrapHandler;
     /**
      * Computed signal indicating if a custom footer is projected
      */
@@ -1300,6 +1349,8 @@ declare class PshModalComponent implements AfterViewInit, OnDestroy {
      * Handles all cleanup when modal closes
      */
     private onModalClose;
+    /** Releases this modal's overlay layer and clears its z-index. */
+    private releaseOverlay;
     /**
      * Checks if the current screen size is mobile
      */
@@ -1320,22 +1371,6 @@ declare class PshModalComponent implements AfterViewInit, OnDestroy {
      * Removes keyboard event listeners
      */
     private removeEventListeners;
-    /**
-     * Focuses the first focusable element in the modal
-     */
-    private focusFirstElement;
-    /**
-     * Restores focus to the element that opened the modal
-     */
-    private restoreFocus;
-    /**
-     * Handles focus trap to keep focus within the modal
-     */
-    private handleFocusTrap;
-    /**
-     * Gets all focusable elements within a container
-     */
-    private getFocusableElements;
     /**
      * Closes the modal and emits the closed event
      */
@@ -1410,7 +1445,8 @@ declare class PshPaginationComponent {
     private readonly uniqueId;
     currentPage: _angular_core.ModelSignal<number>;
     totalPages: _angular_core.ModelSignal<number>;
-    itemsPerPage: _angular_core.ModelSignal<number>;
+    itemsPerPageInput: _angular_core.InputSignal<number>;
+    itemsPerPage: _angular_core.WritableSignal<number>;
     constructor();
     readonly size: _angular_core.InputSignalWithTransform<PaginationSize, PaginationSize>;
     readonly variant: _angular_core.InputSignalWithTransform<PaginationVariant, PaginationVariant>;
@@ -1451,7 +1487,7 @@ declare class PshPaginationComponent {
     onItemsPerPageChange(event: Event): void;
     protected onKeydown(event: KeyboardEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PshPaginationComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PshPaginationComponent, "psh-pagination", never, { "currentPage": { "alias": "currentPage"; "required": false; "isSignal": true; }; "totalPages": { "alias": "totalPages"; "required": false; "isSignal": true; }; "itemsPerPage": { "alias": "itemsPerPage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "showFirstLast": { "alias": "showFirstLast"; "required": false; "isSignal": true; }; "showPrevNext": { "alias": "showPrevNext"; "required": false; "isSignal": true; }; "maxVisiblePages": { "alias": "maxVisiblePages"; "required": false; "isSignal": true; }; "showItemsPerPage": { "alias": "showItemsPerPage"; "required": false; "isSignal": true; }; "itemsPerPageOptions": { "alias": "itemsPerPageOptions"; "required": false; "isSignal": true; }; "firstLabel": { "alias": "firstLabel"; "required": false; "isSignal": true; }; "previousLabel": { "alias": "previousLabel"; "required": false; "isSignal": true; }; "nextLabel": { "alias": "nextLabel"; "required": false; "isSignal": true; }; "lastLabel": { "alias": "lastLabel"; "required": false; "isSignal": true; }; "pageLabel": { "alias": "pageLabel"; "required": false; "isSignal": true; }; "itemsLabel": { "alias": "itemsLabel"; "required": false; "isSignal": true; }; "itemsPerPageLabel": { "alias": "itemsPerPageLabel"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "currentPage": "currentPageChange"; "totalPages": "totalPagesChange"; "itemsPerPage": "itemsPerPageChange"; "pageChange": "pageChange"; "itemsPerPageChange": "itemsPerPageChange"; "navigationError": "navigationError"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PshPaginationComponent, "psh-pagination", never, { "currentPage": { "alias": "currentPage"; "required": false; "isSignal": true; }; "totalPages": { "alias": "totalPages"; "required": false; "isSignal": true; }; "itemsPerPageInput": { "alias": "itemsPerPage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "showFirstLast": { "alias": "showFirstLast"; "required": false; "isSignal": true; }; "showPrevNext": { "alias": "showPrevNext"; "required": false; "isSignal": true; }; "maxVisiblePages": { "alias": "maxVisiblePages"; "required": false; "isSignal": true; }; "showItemsPerPage": { "alias": "showItemsPerPage"; "required": false; "isSignal": true; }; "itemsPerPageOptions": { "alias": "itemsPerPageOptions"; "required": false; "isSignal": true; }; "firstLabel": { "alias": "firstLabel"; "required": false; "isSignal": true; }; "previousLabel": { "alias": "previousLabel"; "required": false; "isSignal": true; }; "nextLabel": { "alias": "nextLabel"; "required": false; "isSignal": true; }; "lastLabel": { "alias": "lastLabel"; "required": false; "isSignal": true; }; "pageLabel": { "alias": "pageLabel"; "required": false; "isSignal": true; }; "itemsLabel": { "alias": "itemsLabel"; "required": false; "isSignal": true; }; "itemsPerPageLabel": { "alias": "itemsPerPageLabel"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "currentPage": "currentPageChange"; "totalPages": "totalPagesChange"; "pageChange": "pageChange"; "itemsPerPageChange": "itemsPerPageChange"; "navigationError": "navigationError"; }, never, never, true, never>;
 }
 
 /**
@@ -1534,7 +1570,7 @@ interface RadioConfig {
     /** Nom du groupe */
     name: string;
     /** Valeur associée */
-    value: any;
+    value: unknown;
     /** Taille du radio */
     size: RadioSize;
     /** Position du label */
@@ -1560,15 +1596,14 @@ declare class PshRadioComponent {
     error: _angular_core.InputSignal<string>;
     success: _angular_core.InputSignal<string>;
     name: _angular_core.InputSignal<string>;
-    value: _angular_core.InputSignal<any>;
+    value: _angular_core.InputSignal<unknown>;
     ariaLabel: _angular_core.InputSignal<string | undefined>;
     size: _angular_core.InputSignal<RadioSize>;
     labelPosition: _angular_core.InputSignal<"left" | "right">;
-    private radioText;
     protected hasProjectedContent: _angular_core.WritableSignal<boolean>;
     checkedChange: EventEmitter<boolean>;
     disabledChange: EventEmitter<boolean>;
-    valueChange: _angular_core.OutputEmitterRef<any>;
+    valueChange: _angular_core.OutputEmitterRef<unknown>;
     customStyles: _angular_core.Signal<any>;
     state: _angular_core.Signal<string>;
     computedAriaLabel: _angular_core.Signal<string | undefined>;
@@ -1583,7 +1618,7 @@ declare class PshRadioComponent {
     private focusNextRadio;
     private focusPreviousRadio;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PshRadioComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PshRadioComponent, "psh-radio", never, { "checkedInput": { "alias": "checked"; "required": false; }; "disabledInput": { "alias": "disabled"; "required": false; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "labelPosition": { "alias": "labelPosition"; "required": false; "isSignal": true; }; }, { "checkedChange": "checkedChange"; "disabledChange": "disabledChange"; "valueChange": "valueChange"; }, ["radioText"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PshRadioComponent, "psh-radio", never, { "checkedInput": { "alias": "checked"; "required": false; }; "disabledInput": { "alias": "disabled"; "required": false; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "labelPosition": { "alias": "labelPosition"; "required": false; "isSignal": true; }; }, { "checkedChange": "checkedChange"; "disabledChange": "disabledChange"; "valueChange": "valueChange"; }, never, ["*"], true, never>;
 }
 
 interface SelectOption<T> {
@@ -1613,6 +1648,9 @@ interface FlatOption<T> {
 declare class PshSelectComponent<T = unknown> implements ControlValueAccessor, FormValueControl<T | T[] | null> {
     private readonly elementRef;
     private readonly destroyRef;
+    private readonly overlayPosition;
+    private readonly injector;
+    protected readonly resolvedSide: _angular_core.WritableSignal<"top" | "bottom">;
     protected readonly selectId: string;
     readonly value: _angular_core.ModelSignal<T | T[] | null>;
     readonly disabled: _angular_core.ModelSignal<boolean>;
@@ -1646,7 +1684,7 @@ declare class PshSelectComponent<T = unknown> implements ControlValueAccessor, F
     scrollEnd: _angular_core.OutputEmitterRef<void>;
     isOpen: _angular_core.Signal<boolean>;
     searchTerm: _angular_core.Signal<string>;
-    state: _angular_core.Signal<"success" | "default" | "disabled" | "error">;
+    state: _angular_core.Signal<"default" | "success" | "disabled" | "error">;
     computedAriaLabel: _angular_core.Signal<string>;
     describedBy: _angular_core.Signal<"error-message" | "success-message" | "hint-message" | null>;
     flatFilteredOptions: _angular_core.Signal<FlatOption<T>[]>;
@@ -1654,11 +1692,12 @@ declare class PshSelectComponent<T = unknown> implements ControlValueAccessor, F
     selectedLabel: _angular_core.Signal<string>;
     filteredOptions: _angular_core.Signal<(SelectOption<T> | SelectOptionGroup<T>)[]>;
     constructor();
+    private reposition;
     private onChange;
     private onTouched;
     writeValue(value: unknown): void;
-    registerOnChange(fn: any): void;
-    registerOnTouched(fn: any): void;
+    registerOnChange(fn: (value: T | T[] | null) => void): void;
+    registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     toggle(): void;
     close(): void;
@@ -1678,7 +1717,7 @@ declare class PshSelectComponent<T = unknown> implements ControlValueAccessor, F
     private focusFirst;
     private focusLast;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PshSelectComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PshSelectComponent<any>, "psh-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "multiplePlaceholder": { "alias": "multiplePlaceholder"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "maxSelections": { "alias": "maxSelections"; "required": false; "isSignal": true; }; "minSelections": { "alias": "minSelections"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; "searchConfig": { "alias": "searchConfig"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "disabled": "disabledChange"; "touched": "touchedChange"; "opened": "opened"; "closed": "closed"; "searched": "searched"; "scrollEnd": "scrollEnd"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PshSelectComponent<any>, "psh-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "multiplePlaceholder": { "alias": "multiplePlaceholder"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "maxSelections": { "alias": "maxSelections"; "required": false; "isSignal": true; }; "minSelections": { "alias": "minSelections"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; "searchConfig": { "alias": "searchConfig"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "disabled": "disabledChange"; "touched": "touchedChange"; "opened": "opened"; "closed": "closed"; "searched": "searched"; "scrollEnd": "scrollEnd"; }, never, never, true, [{ directive: typeof PshClickOutsideDirective; inputs: {}; outputs: {}; }]>;
 }
 
 /**
@@ -1714,9 +1753,8 @@ interface SidebarConfig {
 declare const SIDEBAR_CONFIG: InjectionToken<Partial<SidebarConfig>>;
 declare class PshSidebarComponent implements OnDestroy {
     private readonly config;
-    private readonly elementRef;
     private readonly platformId;
-    private focusedElementBeforeOpen;
+    private readonly document;
     private mediaQueryList;
     private mediaQueryHandler;
     open: _angular_core.ModelSignal<boolean>;
@@ -1738,7 +1776,6 @@ declare class PshSidebarComponent implements OnDestroy {
     effectiveMode: _angular_core.Signal<SidebarMode>;
     state: _angular_core.Signal<string>;
     private readonly escapeHandler;
-    private readonly focusTrapHandler;
     private getState;
     constructor();
     private setupMediaQuery;
@@ -1750,7 +1787,6 @@ declare class PshSidebarComponent implements OnDestroy {
     toggleSidebar(): void;
     closeSidebar(): void;
     handleBackdropClick(): void;
-    private trapFocus;
     ngOnDestroy(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PshSidebarComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PshSidebarComponent, "psh-sidebar", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "breakpoint": { "alias": "breakpoint"; "required": false; "isSignal": true; }; "autoFocus": { "alias": "autoFocus"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "toggle": "toggle"; "opened": "opened"; "closed": "closed"; "transitionStart": "transitionStart"; }, never, ["*"], true, never>;
@@ -1783,6 +1819,7 @@ interface SpinLoaderConfig {
 declare const SPINLOADER_CONFIG: InjectionToken<Partial<SpinLoaderConfig>>;
 declare class PshSpinLoaderComponent {
     private config;
+    private readonly document;
     variant: _angular_core.InputSignal<SpinLoaderVariant>;
     size: _angular_core.InputSignal<SpinLoaderSize>;
     color: _angular_core.InputSignal<SpinLoaderColor>;
@@ -2138,7 +2175,7 @@ interface TableColumn {
     /** Template personnalisé */
     template?: TemplateRef<TableCellContext>;
     /** Fonction de tri personnalisée */
-    sortFn?: (a: any, b: any) => number;
+    sortFn?: (a: TableRow, b: TableRow) => number;
 }
 /**
  * Interface for a row of the table
@@ -2148,8 +2185,8 @@ interface TableRow {
     id: string | number;
     /** Lignes enfants (un seul niveau) */
     children?: TableRow[];
-    /** Données de la ligne */
-    [key: string]: any;
+    /** Données de la ligne (valeurs arbitraires — l'appelant restreint le type) */
+    [key: string]: unknown;
 }
 interface TableRowExpandEvent {
     id: string | number;
@@ -2217,7 +2254,7 @@ declare const TABLE_CONFIG: InjectionToken<Partial<TableConfig>>;
 declare class PshTableComponent {
     private config;
     variant: _angular_core.InputSignal<"default" | "outline">;
-    size: _angular_core.InputSignal<"small" | "medium" | "large">;
+    size: _angular_core.InputSignal<"medium" | "small" | "large">;
     striped: _angular_core.InputSignal<boolean>;
     hoverable: _angular_core.InputSignal<boolean>;
     bordered: _angular_core.InputSignal<boolean>;
@@ -2251,6 +2288,10 @@ declare class PshTableComponent {
      * Trie les données
      */
     private sortData;
+    /**
+     * Compare deux valeurs inconnues (numérique si possible, sinon lexicographique).
+     */
+    private compareValues;
     /**
      * Filtre les données
      */
@@ -2262,7 +2303,7 @@ declare class PshTableComponent {
     handleSort(column: TableColumn): void;
     onSearchValueChange(value: string): void;
     handleRowClick(row: TableRow): void;
-    protected getCellValue(row: TableRow, column: TableColumn): any;
+    protected getCellValue(row: TableRow, column: TableColumn): unknown;
     totalColumns: _angular_core.Signal<number>;
     isRowExpandable(row: TableRow): boolean;
     isRowExpanded(row: TableRow): boolean;
@@ -2346,7 +2387,8 @@ declare class PshTabsComponent {
     tabs: _angular_core.InputSignal<Tab[]>;
     ariaLabel: _angular_core.InputSignal<string | undefined>;
     ariaOrientation: _angular_core.InputSignal<"horizontal" | "vertical">;
-    activeIndex: _angular_core.ModelSignal<number>;
+    activeIndexInput: _angular_core.InputSignal<number>;
+    activeIndex: _angular_core.WritableSignal<number>;
     tabComponents: _angular_core.Signal<readonly PshTabComponent[]>;
     tabsToDisplay: _angular_core.Signal<Tab[]>;
     hasContentProjection: _angular_core.Signal<boolean>;
@@ -2354,7 +2396,7 @@ declare class PshTabsComponent {
     tabChange: _angular_core.OutputEmitterRef<TabChangeEvent>;
     hostClasses: _angular_core.Signal<string>;
     constructor();
-    handleKeyDown(event: KeyboardEvent, index: number): void;
+    handleKeyDown(event: KeyboardEvent, _index: number): void;
     selectTab(index: number): void;
     selectNext(): void;
     selectPrevious(): void;
@@ -2363,7 +2405,7 @@ declare class PshTabsComponent {
     getActiveTab(): Tab | undefined;
     getTabComponent(index: number): PshTabComponent | undefined;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PshTabsComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PshTabsComponent, "psh-tabs", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "animated": { "alias": "animated"; "required": false; "isSignal": true; }; "tabs": { "alias": "tabs"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaOrientation": { "alias": "ariaOrientation"; "required": false; "isSignal": true; }; "activeIndex": { "alias": "activeIndex"; "required": false; "isSignal": true; }; }, { "activeIndex": "activeIndexChange"; "activeIndexChange": "activeIndexChange"; "tabChange": "tabChange"; }, ["tabComponents"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PshTabsComponent, "psh-tabs", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "animated": { "alias": "animated"; "required": false; "isSignal": true; }; "tabs": { "alias": "tabs"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaOrientation": { "alias": "ariaOrientation"; "required": false; "isSignal": true; }; "activeIndexInput": { "alias": "activeIndex"; "required": false; "isSignal": true; }; }, { "activeIndexChange": "activeIndexChange"; "tabChange": "tabChange"; }, ["tabComponents"], ["*"], true, never>;
 }
 
 /**
@@ -2498,6 +2540,7 @@ declare const TOOLTIP_CONFIG: InjectionToken<Partial<TooltipConfig>>;
 declare class PshTooltipComponent implements AfterViewInit, OnDestroy {
     private config;
     private elementRef;
+    private readonly overlayPosition;
     variant: _angular_core.InputSignal<TooltipVariant>;
     position: _angular_core.InputSignal<TooltipPosition>;
     showDelay: _angular_core.InputSignal<number>;
@@ -2556,6 +2599,8 @@ declare const PSH_THEME_OPTIONS: InjectionToken<PshThemeOptions>;
 declare class ThemeService {
     private customerContext;
     private options;
+    private readonly document;
+    private readonly isBrowser;
     private isDarkThemeSignal;
     private themeNameSignal;
     private lastChangeSignal;
@@ -2583,22 +2628,24 @@ declare class ThemeService {
     private derivePalette;
     private ensureIfInteractive;
     private initializeTheme;
+    /** True when the OS/browser requests a dark colour scheme. */
+    private prefersDarkScheme;
     private saveThemePreference;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThemeService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ThemeService>;
 }
 
 interface TranslationProvider {
-    translate(key: string, params?: Record<string, any>): string;
-    translateAsync(key: string, params?: Record<string, any>): Observable<string>;
+    translate(key: string, params?: Record<string, unknown>): string;
+    translateAsync(key: string, params?: Record<string, unknown>): Observable<string>;
     setLanguage(lang: string): void;
     getCurrentLanguage(): string;
     onLangChange(): Observable<string>;
 }
 declare class NgxTranslateProvider implements TranslationProvider {
     private translateService;
-    translate(key: string, params?: Record<string, any>): string;
-    translateAsync(key: string, params?: Record<string, any>): Observable<string>;
+    translate(key: string, params?: Record<string, unknown>): string;
+    translateAsync(key: string, params?: Record<string, unknown>): Observable<string>;
     setLanguage(lang: string): void;
     getCurrentLanguage(): string;
     onLangChange(): Observable<string>;
@@ -2621,11 +2668,188 @@ interface TranslationEntry {
 }
 
 declare class ScrollService {
-    private router;
-    constructor(router: Router);
+    private readonly router;
+    private readonly document;
+    private readonly isBrowser;
+    constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ScrollService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ScrollService>;
 }
 
-export { CHECKBOX_CONFIG, CUSTOMER_CONTEXT_SERVICE, INPUT_LABELS, MODAL_CONFIG, ModalService, NgxTranslateProvider, PAGINATION_CONFIG, PROGRESSBAR_CONFIG, PSH_THEME_OPTIONS, PshAlertComponent, PshAvatarComponent, PshBadgeComponent, PshButtonComponent, PshCardComponent, PshCheckboxComponent, PshCollapseComponent, PshDropdownComponent, PshFlowStepComponent, PshHorizontalCardComponent, PshInfoCardComponent, PshInputComponent, PshMenuComponent, PshModalComponent, PshPaginationComponent, PshProgressbarComponent, PshRadioComponent, PshSelectComponent, PshSidebarComponent, PshSpinLoaderComponent, PshStatCardComponent, PshStateFlowIndicatorComponent, PshStepComponent, PshStepperComponent, PshSwitchComponent, PshTabBarComponent, PshTabComponent, PshTableComponent, PshTabsComponent, PshTagComponent, PshTextareaComponent, PshToastComponent, PshToastService, PshTooltipComponent, RADIO_CONFIG, RADIO_STYLES, SIDEBAR_CONFIG, SPINLOADER_CONFIG, STATE_FLOW_INDICATOR_CONFIG, STEPPER_CONFIG, SWITCH_CONFIG, ScrollService, TABLE_CONFIG, TABS_CONFIG, TAB_BAR_CONFIG, TAG_CONFIG, TEXTAREA_LABELS, TOAST_CONFIG, TOOLTIP_CONFIG, TRANSLATION_PROVIDER, ThemeService, ToastComponent, ToastService, provideTranslation };
-export type { AlertConfig, AlertLabels, AlertRole, AlertSize, AlertType, AutocompleteConfig, AvatarConfig, AvatarShape, AvatarSize, AvatarStatus, BadgeDisplayType, BadgePosition, BadgeSize, BadgeVariant, ButtonAppearance, ButtonIconPosition, ButtonSize, ButtonVariant, CardActionsAlignment, CardColorVariant, CardDensity, CardVariant, CheckboxConfig, CheckboxLabelPosition, CheckboxSize, CollapseSize, CollapseVariant, CustomerContextService, DropdownAppearance, DropdownConfig, DropdownItem, DropdownPlacement, DropdownSize, DropdownVariant, FlowStepConfig, IconPosition, InfoCardData, InfoCardOptions, InfoCardVariant, InputConfig, InputSize, InputType, InputVariant, MenuItem, MenuMode, MenuVariant, ModalConfig, ModalSize, PaginationConfig, PaginationSize, PaginationVariant, ProgressbarConfig, ProgressbarLabelPosition, ProgressbarMode, ProgressbarSize, ProgressbarVariant, PshThemeOptions, RadioConfig, RadioSize, SearchConfig, SelectOption, SelectOptionGroup, SelectSize, SelectVariant, SidebarConfig, SidebarMode, SidebarPosition, SpinLoaderColor, SpinLoaderConfig, SpinLoaderSize, SpinLoaderVariant, StatCardLayout, StatCardVariant, StatTagVariant, StateFlowIndicatorAriaLabels, StateFlowIndicatorConfig, StateFlowIndicatorSize, StepConfig, StepperAriaLabels, StepperConfig, StepperVariant, SuggestionResult, SwitchConfig, SwitchSize, Tab, TabBarChangeEvent, TabBarConfig, TabBarItem, TabChangeEvent, TableCellContext, TableColumn, TableConfig, TableExpandedRowContext, TableRow, TableRowClickEvent, TableRowExpandEvent, TableSort, TabsConfig, TabsSize, TabsVariant, TagConfig, TagSize, TagVariant, TextareaConfig, TextareaResize, TextareaSize, TextareaVariant, Theme, ThemeConfig, Toast, ToastConfig, ToastPosition, ToastType, TooltipConfig, TooltipPosition, TooltipVariant, TranslationConfig, TranslationEntry, TranslationProvider };
+/**
+ * Headless focus-trap primitive.
+ *
+ * Apply to a container element and toggle activation with `[pshFocusTrap]`.
+ * When active it:
+ * - remembers the element that had focus before activation,
+ * - moves focus to the first focusable element inside the container
+ *   (deterministically, after the next render — no `setTimeout`),
+ * - keeps Tab / Shift+Tab focus cycling within the container, and
+ * - restores focus to the previously focused element on deactivation/destroy.
+ *
+ * Handles the case where focus is currently outside the container.
+ *
+ * @example
+ * ```html
+ * <div [pshFocusTrap]="isOpen()">…</div>
+ * ```
+ */
+declare class PshFocusTrapDirective {
+    private readonly host;
+    private readonly document;
+    private readonly injector;
+    private readonly isBrowser;
+    /** Whether the trap is active. */
+    readonly pshFocusTrap: _angular_core.InputSignal<boolean>;
+    /** Whether to restore focus to the previously focused element on deactivation. */
+    readonly pshFocusTrapRestore: _angular_core.InputSignal<boolean>;
+    /**
+     * Whether to move focus into the container when the trap activates.
+     * Set to false to trap + restore focus without stealing initial focus.
+     */
+    readonly pshFocusTrapAutoFocus: _angular_core.InputSignal<boolean>;
+    private previouslyFocused;
+    private active;
+    constructor();
+    protected onKeydown(event: KeyboardEvent): void;
+    private activate;
+    private deactivate;
+    private restoreFocus;
+    private getFocusableElements;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PshFocusTrapDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PshFocusTrapDirective, "[pshFocusTrap]", never, { "pshFocusTrap": { "alias": "pshFocusTrap"; "required": false; "isSignal": true; }; "pshFocusTrapRestore": { "alias": "pshFocusTrapRestore"; "required": false; "isSignal": true; }; "pshFocusTrapAutoFocus": { "alias": "pshFocusTrapAutoFocus"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+type AnnouncerPoliteness = 'polite' | 'assertive';
+/**
+ * Centralised ARIA live-region announcer.
+ *
+ * Provides a single pair of visually-hidden `aria-live` regions (polite and
+ * assertive) shared across the whole application, instead of every component
+ * rendering its own live region. Inject it and call {@link announce} to read a
+ * message to assistive technology (toasts, async loading, form validation…).
+ *
+ * @example
+ * ```typescript
+ * private announcer = inject(PshLiveAnnouncerService);
+ * this.announcer.announce('3 results found');
+ * this.announcer.announce('Save failed', 'assertive');
+ * ```
+ */
+declare class PshLiveAnnouncerService {
+    private readonly document;
+    private readonly isBrowser;
+    private politeRegion;
+    private assertiveRegion;
+    constructor();
+    /**
+     * Announces a message in the requested live region.
+     * The region is cleared first so the same message announced twice is re-read.
+     */
+    announce(message: string, politeness?: AnnouncerPoliteness): void;
+    /** Clears both live regions. */
+    clear(): void;
+    private getRegion;
+    private createRegion;
+    private dispose;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PshLiveAnnouncerService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<PshLiveAnnouncerService>;
+}
+
+/** A cardinal side an overlay can be placed on, relative to its anchor. */
+type OverlaySide = 'top' | 'bottom' | 'left' | 'right';
+/** Options describing the (estimated) overlay size and the gap to the anchor. */
+interface OverlayPositionOptions {
+    /** Estimated overlay width in px (used for left/right flipping and align flipping). */
+    overlayWidth?: number;
+    /** Estimated overlay height in px (used for top/bottom flipping). */
+    overlayHeight?: number;
+    /** Minimum gap between anchor and overlay in px. */
+    offset?: number;
+}
+/**
+ * Shared anchored-positioning primitive with viewport collision detection.
+ *
+ * Computes whether an overlay (tooltip, dropdown, select panel, menu…) fits on
+ * its preferred side of an anchor element and flips it to the opposite side
+ * when there is not enough room and the opposite side has more. Based on
+ * `getBoundingClientRect`, so it must be called when the anchor is laid out
+ * (i.e. in the browser, on open / scroll / resize).
+ *
+ * This generalises the collision logic that previously lived only inside the
+ * tooltip, so dropdown / select / menu popovers can stop overflowing too.
+ */
+declare class PshOverlayPositionService {
+    private readonly document;
+    /**
+     * Resolves the best cardinal side for an overlay, flipping `preferred` to its
+     * opposite when it would overflow the viewport and the opposite has more room.
+     */
+    flipSide(anchor: HTMLElement, preferred: OverlaySide, options?: OverlayPositionOptions): OverlaySide;
+    /**
+     * Resolves a `"<side>"` or `"<side>-<align>"` placement string (e.g. `top`,
+     * `bottom-start`, `top-end`), flipping the side to fit the viewport while
+     * preserving the alignment. Unknown placements are returned unchanged.
+     *
+     * @example
+     * ```typescript
+     * // Near the bottom of the viewport with no room below:
+     * positions.flipPlacement(trigger, 'bottom-start', { overlayHeight: 240 });
+     * // => 'top-start'
+     * ```
+     */
+    flipPlacement(anchor: HTMLElement, preferred: string, options?: OverlayPositionOptions): string;
+    private isSide;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PshOverlayPositionService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<PshOverlayPositionService>;
+}
+
+/** A handle for a registered overlay layer. */
+interface OverlayHandle {
+    /** Unique id of the layer, used to release it. */
+    readonly id: number;
+    /** z-index assigned to this layer (higher = on top). */
+    readonly zIndex: number;
+}
+/**
+ * Central overlay stacking authority.
+ *
+ * Hands out monotonically increasing z-indexes so that stacked overlays
+ * (modals, dropdowns, tooltips, popovers…) always layer in open order, and
+ * exposes which layer is on top. This replaces per-component, ad-hoc z-index
+ * management. The counter resets once every layer is released, keeping z-index
+ * values bounded.
+ *
+ * @example
+ * ```typescript
+ * private overlay = inject(PshOverlayService);
+ * // on open:
+ * this.handle = this.overlay.push();      // { id, zIndex }
+ * // on close:
+ * this.overlay.remove(this.handle.id);
+ * ```
+ */
+declare class PshOverlayService {
+    /** z-index of the first (bottom) overlay layer. */
+    private readonly baseZIndex;
+    /** z-index increment between stacked layers. */
+    private readonly step;
+    private sequence;
+    private readonly stack;
+    /** Number of currently-open overlay layers. */
+    readonly activeCount: _angular_core.Signal<number>;
+    /**
+     * Registers a new topmost overlay layer.
+     * @returns a handle with a unique id and the z-index to apply.
+     */
+    push(): OverlayHandle;
+    /** Releases a previously registered layer. */
+    remove(id: number): void;
+    /** Returns true if the given layer is currently on top of the stack. */
+    isTopmost(id: number): boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PshOverlayService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<PshOverlayService>;
+}
+
+export { CHECKBOX_CONFIG, CUSTOMER_CONTEXT_SERVICE, INPUT_LABELS, MODAL_CONFIG, ModalService, NgxTranslateProvider, PAGINATION_CONFIG, PROGRESSBAR_CONFIG, PSH_THEME_OPTIONS, PshAlertComponent, PshAvatarComponent, PshBadgeComponent, PshButtonComponent, PshCardComponent, PshCheckboxComponent, PshClickOutsideDirective, PshCollapseComponent, PshDropdownComponent, PshFlowStepComponent, PshFocusTrapDirective, PshHorizontalCardComponent, PshInfoCardComponent, PshInputComponent, PshLiveAnnouncerService, PshMenuComponent, PshModalComponent, PshOverlayPositionService, PshOverlayService, PshPaginationComponent, PshProgressbarComponent, PshRadioComponent, PshSelectComponent, PshSidebarComponent, PshSpinLoaderComponent, PshStatCardComponent, PshStateFlowIndicatorComponent, PshStepComponent, PshStepperComponent, PshSwitchComponent, PshTabBarComponent, PshTabComponent, PshTableComponent, PshTabsComponent, PshTagComponent, PshTextareaComponent, PshToastComponent, PshToastService, PshTooltipComponent, RADIO_CONFIG, RADIO_STYLES, SIDEBAR_CONFIG, SPINLOADER_CONFIG, STATE_FLOW_INDICATOR_CONFIG, STEPPER_CONFIG, SWITCH_CONFIG, ScrollService, TABLE_CONFIG, TABS_CONFIG, TAB_BAR_CONFIG, TAG_CONFIG, TEXTAREA_LABELS, TOAST_CONFIG, TOOLTIP_CONFIG, TRANSLATION_PROVIDER, ThemeService, ToastComponent, ToastService, provideTranslation };
+export type { AlertConfig, AlertLabels, AlertRole, AlertSize, AlertType, AnnouncerPoliteness, AutocompleteConfig, AvatarConfig, AvatarShape, AvatarSize, AvatarStatus, BadgeDisplayType, BadgePosition, BadgeSize, BadgeVariant, ButtonAppearance, ButtonIconPosition, ButtonSize, ButtonVariant, CardActionsAlignment, CardColorVariant, CardDensity, CardVariant, CheckboxConfig, CheckboxLabelPosition, CheckboxSize, CollapseSize, CollapseVariant, CustomerContextService, DropdownAppearance, DropdownConfig, DropdownItem, DropdownPlacement, DropdownSize, DropdownVariant, FlowStepConfig, IconPosition, InfoCardData, InfoCardOptions, InfoCardVariant, InputConfig, InputSize, InputType, InputVariant, MenuItem, MenuMode, MenuVariant, ModalConfig, ModalSize, OverlayHandle, OverlayPositionOptions, OverlaySide, PaginationConfig, PaginationSize, PaginationVariant, ProgressbarConfig, ProgressbarLabelPosition, ProgressbarMode, ProgressbarSize, ProgressbarVariant, PshThemeOptions, RadioConfig, RadioSize, SearchConfig, SelectOption, SelectOptionGroup, SelectSize, SelectVariant, SidebarConfig, SidebarMode, SidebarPosition, SpinLoaderColor, SpinLoaderConfig, SpinLoaderSize, SpinLoaderVariant, StatCardLayout, StatCardVariant, StatTagVariant, StateFlowIndicatorAriaLabels, StateFlowIndicatorConfig, StateFlowIndicatorSize, StepConfig, StepperAriaLabels, StepperConfig, StepperVariant, SuggestionResult, SwitchConfig, SwitchSize, Tab, TabBarChangeEvent, TabBarConfig, TabBarItem, TabChangeEvent, TableCellContext, TableColumn, TableConfig, TableExpandedRowContext, TableRow, TableRowClickEvent, TableRowExpandEvent, TableSort, TabsConfig, TabsSize, TabsVariant, TagConfig, TagSize, TagVariant, TextareaConfig, TextareaResize, TextareaSize, TextareaVariant, Theme, ThemeConfig, Toast, ToastConfig, ToastPosition, ToastType, TooltipConfig, TooltipPosition, TooltipVariant, TranslationConfig, TranslationEntry, TranslationProvider };