ng-primitives 0.121.0 → 0.123.0

package/types/ng-primitives-internal.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { OnDestroy, ClassProvider, EffectCleanupRegisterFn, CreateEffectOptions, EffectRef, ElementRef, Signal, Injector } from '@angular/core';
+import { OnDestroy, ClassProvider, Signal, EffectCleanupRegisterFn, CreateEffectOptions, EffectRef, ElementRef, Injector } from '@angular/core';
 import { Observable } from 'rxjs';
 
 declare class NgpExitAnimation implements OnDestroy {
@@ -45,6 +45,98 @@ declare class NgpExitAnimationManager {
 declare function provideExitAnimationManager(): ClassProvider;
 declare function injectExitAnimationManager(): NgpExitAnimationManager;
 
+/**
+ * Fallback timeout (ms) after which an idle hover bridge closes the overlay.
+ * Shared so tooltip, menu and submenu hover-intent behaviour stay in sync.
+ */
+declare const HOVER_BRIDGE_TIMEOUT_MS = 150;
+/**
+ * Pointer movement below this magnitude (px) on the intent axis is treated as
+ * jitter, not a reversal, so a tiny backward twitch doesn't collapse the bridge.
+ */
+declare const HOVER_BRIDGE_DIRECTION_TOLERANCE_PX = 2;
+interface HoverBridgePoint {
+    x: number;
+    y: number;
+}
+/**
+ * The dominant axis and sign pointing from the trigger toward the target. Used
+ * to reject pointer movement heading away from the target while inside the corridor.
+ */
+interface HoverBridgeDirection {
+    axis: 'x' | 'y';
+    sign: 1 | -1;
+}
+interface CreateHoverBridgePolygonOptions {
+    triggerRect: DOMRect | null;
+    targetRect: DOMRect | null;
+    exitPoint: HoverBridgePoint;
+    corridorHalfSize?: number;
+}
+/**
+ * Computes the dominant axis and sign from the trigger toward the target - i.e.
+ * which way the pointer must travel to reach the panel. Returns null if either
+ * rect is missing.
+ */
+declare function getHoverBridgeDirection(triggerRect: DOMRect | null, targetRect: DOMRect | null): HoverBridgeDirection | null;
+/**
+ * Builds a pointer grace polygon between the trigger exit point and the target overlay.
+ * The polygon is intentionally directional so moving away from the target exits quickly.
+ */
+declare function createHoverBridgePolygon({ triggerRect, targetRect, exitPoint, corridorHalfSize, }: CreateHoverBridgePolygonOptions): HoverBridgePoint[] | null;
+/**
+ * Returns true when the point lies inside the provided polygon.
+ */
+declare function isPointInHoverBridgePolygon(point: HoverBridgePoint, polygon: HoverBridgePoint[]): boolean;
+
+interface HoverBridgeOptions {
+    /** Whether the pointer is currently over the trigger or the panel (the "safe" area). */
+    isPointerInAnchor: () => boolean;
+    /** Close the overlay - called when the pointer leaves the corridor or the idle timer fires. */
+    close: () => void;
+    /**
+     * Require the pointer to keep heading toward the panel. When true, reversing
+     * away along the corridor's dominant axis closes the overlay (menu/submenu).
+     * Tooltips leave this off. Defaults to false.
+     */
+    requireForwardMovement?: boolean;
+    /**
+     * Reset the idle-fallback timer on valid in-corridor movement, so it only
+     * fires after the pointer genuinely stops. When false the timer is a fixed cap
+     * from the moment the corridor is built (tooltip's original semantics).
+     * Defaults to true.
+     */
+    resetFallbackOnMove?: boolean;
+    /** Idle-fallback timeout in ms. Defaults to HOVER_BRIDGE_TIMEOUT_MS. */
+    timeoutMs?: number;
+}
+interface HoverBridgeTrackOptions {
+    triggerRect: DOMRect | null;
+    targetRect: DOMRect | null;
+    exitPoint: HoverBridgePoint;
+}
+interface HoverBridgeController {
+    /** The active corridor polygon, or null when no bridge is in progress. */
+    readonly polygon: Signal<HoverBridgePoint[] | null>;
+    /** Whether a corridor is currently active. */
+    isActive(): boolean;
+    /**
+     * Build a corridor from the exit point toward the panel and start tracking the
+     * pointer. Returns false (and does nothing) when a polygon can't be built, so
+     * the caller can apply its own fallback.
+     */
+    track(options: HoverBridgeTrackOptions): boolean;
+    /** Tear down the corridor and its global listener/timer. */
+    clear(): void;
+}
+/**
+ * Shared safe-polygon hover-intent state machine used by the menu, submenu and
+ * tooltip triggers. While the pointer travels inside the corridor toward the
+ * panel the overlay stays open; it closes when the pointer leaves the corridor,
+ * reverses away (when requireForwardMovement is set) or idles past the timeout.
+ */
+declare function createHoverBridge({ isPointerInAnchor, close, requireForwardMovement, resetFallbackOnMove, timeoutMs, }: HoverBridgeOptions): HoverBridgeController;
+
 /**
  * This implementation is heavily inspired by the great work on ngextension!
  * https://github.com/ngxtension/ngxtension-platform/blob/main/libs/ngxtension/explicit-effect/src/explicit-effect.ts
@@ -210,5 +302,5 @@ declare function injectDimensions(): Signal<Dimensions>;
 
 declare function scrollIntoViewIfNeeded(element: HTMLElement): void;
 
-export { NgpExitAnimation, NgpExitAnimationManager, StyleInjector, domSort, explicitEffect, fromMutationObserver, fromResizeEvent, injectDimensions, injectElementRef, injectExitAnimationManager, injectStyleInjector, observeResize, onDomRemoval, provideExitAnimationManager, scrollIntoViewIfNeeded, setupExitAnimation, setupOverflowListener };
-export type { Dimensions, NgpExitAnimationRef };
+export { HOVER_BRIDGE_DIRECTION_TOLERANCE_PX, HOVER_BRIDGE_TIMEOUT_MS, NgpExitAnimation, NgpExitAnimationManager, StyleInjector, createHoverBridge, createHoverBridgePolygon, domSort, explicitEffect, fromMutationObserver, fromResizeEvent, getHoverBridgeDirection, injectDimensions, injectElementRef, injectExitAnimationManager, injectStyleInjector, isPointInHoverBridgePolygon, observeResize, onDomRemoval, provideExitAnimationManager, scrollIntoViewIfNeeded, setupExitAnimation, setupOverflowListener };
+export type { Dimensions, HoverBridgeController, HoverBridgeDirection, HoverBridgeOptions, HoverBridgePoint, HoverBridgeTrackOptions, NgpExitAnimationRef };

package/types/ng-primitives-menu.d.ts

@@ -393,6 +393,11 @@ interface NgpMenuTriggerState<T = unknown> {
      * Whether the menu should flip when there is not enough space.
      */
     readonly flip: WritableSignal<NgpFlip>;
+    /**
+     * The container in which the menu should be attached.
+     * @default document.body
+     */
+    readonly container: WritableSignal<HTMLElement | string | null>;
     /**
      * The context provided to the menu.
      */
@@ -427,6 +432,12 @@ interface NgpMenuTriggerState<T = unknown> {
      * @param context - The new context
      */
     setContext(context: T): void;
+    /**
+     * Set the container in which the menu should be attached. Takes effect the
+     * next time the menu is opened; it does not move a menu that is already open.
+     * @param container - The new container
+     */
+    setContainer(container: HTMLElement | string | null): void;
     /**
      * Show the menu.
      * @param origin - The focus origin
@@ -526,10 +537,12 @@ declare const NgpMenuTriggerStateToken: _angular_core.InjectionToken<WritableSig
     setPlacement: (newPlacement: NgpMenuPlacement) => void;
     setOffset: (newOffset: NgpOffset) => void;
     setContext: (newContext: unknown) => void;
+    setContainer: (newContainer: HTMLElement | string | null) => void;
     setPointerOverContent: (isOver: boolean) => void;
     flip: WritableSignal<NgpFlip>;
+    container: WritableSignal<string | HTMLElement | null>;
 }>>;
-declare const ngpMenuTrigger: <T>({ disabled: _disabled, menu: _menu, placement: _placement, offset: _offset, flip: _flip, shift: _shift, context: _context, container, scrollBehavior, cooldown, triggers, showDelay, hideDelay, }: NgpMenuTriggerProps<T>) => {
+declare const ngpMenuTrigger: <T>({ disabled: _disabled, menu: _menu, placement: _placement, offset: _offset, flip: _flip, shift: _shift, context: _context, container: _container, scrollBehavior, cooldown, triggers, showDelay, hideDelay, }: NgpMenuTriggerProps<T>) => {
     menu: WritableSignal<NgpOverlayContent<T> | undefined>;
     placement: WritableSignal<NgpMenuPlacement>;
     offset: WritableSignal<NgpOffset>;
@@ -546,8 +559,10 @@ declare const ngpMenuTrigger: <T>({ disabled: _disabled, menu: _menu, placement:
     setPlacement: (newPlacement: NgpMenuPlacement) => void;
     setOffset: (newOffset: NgpOffset) => void;
     setContext: (newContext: T) => void;
+    setContainer: (newContainer: HTMLElement | string | null) => void;
     setPointerOverContent: (isOver: boolean) => void;
     flip: WritableSignal<NgpFlip>;
+    container: WritableSignal<string | HTMLElement | null>;
 };
 declare const provideMenuTriggerState: (opts?: {
     inherit?: boolean;
@@ -638,6 +653,11 @@ declare class NgpSubmenuTrigger<T = unknown> {
      * @default true
      */
     readonly flip: _angular_core.InputSignalWithTransform<NgpFlip, NgpFlipInput>;
+    /**
+     * Define the container in which the menu should be attached.
+     * @default document.body
+     */
+    readonly container: _angular_core.InputSignal<string | HTMLElement | null>;
     /**
      * Access the menu trigger state.
      */
@@ -661,7 +681,7 @@ declare class NgpSubmenuTrigger<T = unknown> {
      */
     focus(origin?: FocusOrigin): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgpSubmenuTrigger<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgpSubmenuTrigger<any>, "[ngpSubmenuTrigger]", ["ngpSubmenuTrigger"], { "menu": { "alias": "ngpSubmenuTrigger"; "required": false; "isSignal": true; }; "disabled": { "alias": "ngpSubmenuTriggerDisabled"; "required": false; "isSignal": true; }; "placement": { "alias": "ngpSubmenuTriggerPlacement"; "required": false; "isSignal": true; }; "offset": { "alias": "ngpSubmenuTriggerOffset"; "required": false; "isSignal": true; }; "flip": { "alias": "ngpSubmenuTriggerFlip"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgpSubmenuTrigger<any>, "[ngpSubmenuTrigger]", ["ngpSubmenuTrigger"], { "menu": { "alias": "ngpSubmenuTrigger"; "required": false; "isSignal": true; }; "disabled": { "alias": "ngpSubmenuTriggerDisabled"; "required": false; "isSignal": true; }; "placement": { "alias": "ngpSubmenuTriggerPlacement"; "required": false; "isSignal": true; }; "offset": { "alias": "ngpSubmenuTriggerOffset"; "required": false; "isSignal": true; }; "flip": { "alias": "ngpSubmenuTriggerFlip"; "required": false; "isSignal": true; }; "container": { "alias": "ngpSubmenuTriggerContainer"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 interface NgpSubmenuTriggerState {
@@ -689,6 +709,11 @@ interface NgpSubmenuTriggerState {
      * Whether the menu should flip when there is not enough space.
      */
     readonly flip: WritableSignal<NgpFlip>;
+    /**
+     * The container in which the menu should be attached.
+     * @default document.body
+     */
+    readonly container: WritableSignal<HTMLElement | string | null>;
     /**
      * The focus origin used to open the submenu.
      * Used by the submenu's focus trap for :focus-visible styling.
@@ -735,14 +760,20 @@ interface NgpSubmenuTriggerState {
      * @param shouldFlip - Whether the menu should flip
      */
     setFlip(shouldFlip: NgpFlip): void;
+    /**
+     * Set the container in which the menu should be attached. Takes effect the
+     * next time the menu is opened; it does not move a menu that is already open.
+     * @param container - The new container
+     */
+    setContainer(container: HTMLElement | string | null): void;
     /**
      * Focus the trigger element.
      * @param origin - The focus origin
      */
     focus(origin: FocusOrigin): void;
     /**
-     * Set whether the pointer is over the menu content.
-     * For submenus, this is a no-op as hover is handled via showSubmenuOnHover.
+     * Set whether the pointer is over the submenu content. Entering the submenu
+     * tears down the hover bridge (the pointer arrived safely).
      * @param isOver - Whether the pointer is over the content
      * @internal
      */
@@ -769,6 +800,10 @@ interface NgpSubmenuTriggerProps<T = unknown> {
      * Whether the menu should flip when there is not enough space.
      */
     readonly flip?: Signal<NgpFlip>;
+    /**
+     * The container in which the menu should be attached.
+     */
+    readonly container?: Signal<HTMLElement | string | null>;
 }
 declare const NgpSubmenuTriggerStateToken: _angular_core.InjectionToken<WritableSignal<{
     placement: WritableSignal<NgpMenuPlacement>;
@@ -786,10 +821,12 @@ declare const NgpSubmenuTriggerStateToken: _angular_core.InjectionToken<Writable
     setFlip: (shouldFlip: NgpFlip) => void;
     setPlacement: (newPlacement: NgpMenuPlacement) => void;
     setOffset: (newOffset: NgpOffset) => void;
+    setContainer: (newContainer: HTMLElement | string | null) => void;
     focus: (origin: FocusOrigin) => void;
-    setPointerOverContent: (_isOver: boolean) => void;
+    setPointerOverContent: (isOver: boolean) => void;
+    container: WritableSignal<string | HTMLElement | null>;
 }>>;
-declare const ngpSubmenuTrigger: <T>({ disabled: _disabled, menu: _menu, placement: _placement, offset: _offset, flip: _flip, }: NgpSubmenuTriggerProps<T>) => {
+declare const ngpSubmenuTrigger: <T>({ disabled: _disabled, menu: _menu, placement: _placement, offset: _offset, flip: _flip, container: _container, }: NgpSubmenuTriggerProps<T>) => {
     placement: WritableSignal<NgpMenuPlacement>;
     offset: WritableSignal<NgpOffset>;
     disabled: WritableSignal<boolean>;
@@ -805,8 +842,10 @@ declare const ngpSubmenuTrigger: <T>({ disabled: _disabled, menu: _menu, placeme
     setFlip: (shouldFlip: NgpFlip) => void;
     setPlacement: (newPlacement: NgpMenuPlacement) => void;
     setOffset: (newOffset: NgpOffset) => void;
+    setContainer: (newContainer: HTMLElement | string | null) => void;
     focus: (origin: FocusOrigin) => void;
-    setPointerOverContent: (_isOver: boolean) => void;
+    setPointerOverContent: (isOver: boolean) => void;
+    container: WritableSignal<string | HTMLElement | null>;
 };
 declare const injectSubmenuTriggerState: {
     (): Signal<{
@@ -825,8 +864,10 @@ declare const injectSubmenuTriggerState: {
         setFlip: (shouldFlip: NgpFlip) => void;
         setPlacement: (newPlacement: NgpMenuPlacement) => void;
         setOffset: (newOffset: NgpOffset) => void;
+        setContainer: (newContainer: HTMLElement | string | null) => void;
         focus: (origin: FocusOrigin) => void;
-        setPointerOverContent: (_isOver: boolean) => void;
+        setPointerOverContent: (isOver: boolean) => void;
+        container: WritableSignal<string | HTMLElement | null>;
     }>;
     (options: ng_primitives_state.StateInjectionOptions): Signal<{
         placement: WritableSignal<NgpMenuPlacement>;
@@ -844,8 +885,10 @@ declare const injectSubmenuTriggerState: {
         setFlip: (shouldFlip: NgpFlip) => void;
         setPlacement: (newPlacement: NgpMenuPlacement) => void;
         setOffset: (newOffset: NgpOffset) => void;
+        setContainer: (newContainer: HTMLElement | string | null) => void;
         focus: (origin: FocusOrigin) => void;
-        setPointerOverContent: (_isOver: boolean) => void;
+        setPointerOverContent: (isOver: boolean) => void;
+        container: WritableSignal<string | HTMLElement | null>;
     } | null>;
     (options?: ng_primitives_state.StateInjectionOptions): Signal<{
         placement: WritableSignal<NgpMenuPlacement>;
@@ -863,8 +906,10 @@ declare const injectSubmenuTriggerState: {
         setFlip: (shouldFlip: NgpFlip) => void;
         setPlacement: (newPlacement: NgpMenuPlacement) => void;
         setOffset: (newOffset: NgpOffset) => void;
+        setContainer: (newContainer: HTMLElement | string | null) => void;
         focus: (origin: FocusOrigin) => void;
-        setPointerOverContent: (_isOver: boolean) => void;
+        setPointerOverContent: (isOver: boolean) => void;
+        container: WritableSignal<string | HTMLElement | null>;
     }> | Signal<{
         placement: WritableSignal<NgpMenuPlacement>;
         offset: WritableSignal<NgpOffset>;
@@ -881,8 +926,10 @@ declare const injectSubmenuTriggerState: {
         setFlip: (shouldFlip: NgpFlip) => void;
         setPlacement: (newPlacement: NgpMenuPlacement) => void;
         setOffset: (newOffset: NgpOffset) => void;
+        setContainer: (newContainer: HTMLElement | string | null) => void;
         focus: (origin: FocusOrigin) => void;
-        setPointerOverContent: (_isOver: boolean) => void;
+        setPointerOverContent: (isOver: boolean) => void;
+        container: WritableSignal<string | HTMLElement | null>;
     } | null>;
 };
 declare const provideSubmenuTriggerState: (opts?: {

package/types/ng-primitives-navigation-menu.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, Provider, Signal } from '@angular/core';
+import { InjectionToken, Provider, Signal, WritableSignal } from '@angular/core';
 import { Placement } from '@floating-ui/dom';
 import { NgpOrientation } from 'ng-primitives/common';
 import { NgpOffset, NgpFlip, NgpShift, NgpOverlayContent, NgpOffsetInput, NgpFlipInput, NgpShiftInput } from 'ng-primitives/portal';
@@ -635,7 +635,7 @@ interface NgpNavigationMenuTriggerState {
     /**
      * The container for the content.
      */
-    readonly container: Signal<HTMLElement | string | null>;
+    readonly container: WritableSignal<HTMLElement | string | null>;
     /**
      * Whether the content is currently open.
      */
@@ -670,6 +670,13 @@ interface NgpNavigationMenuTriggerState {
      * @param id The content ID
      */
     setContentId(id: string): void;
+    /**
+     * Set the container in which the content should be attached. Takes effect the
+     * next time the content is opened; it does not move content that is already
+     * open.
+     * @param container The new container
+     */
+    setContainer(container: HTMLElement | string | null): void;
     /**
      * Update pointer over content state.
      * @param isOver Whether pointer is over content
@@ -721,14 +728,14 @@ interface NgpNavigationMenuTriggerProps {
      */
     readonly cooldown?: Signal<number>;
 }
-declare const NgpNavigationMenuTriggerStateToken: _angular_core.InjectionToken<_angular_core.WritableSignal<{
+declare const NgpNavigationMenuTriggerStateToken: _angular_core.InjectionToken<WritableSignal<{
     content: Signal<NgpOverlayContent<unknown> | undefined>;
     disabled: Signal<boolean>;
     placement: Signal<Placement>;
     offset: Signal<NgpOffset>;
     flip: Signal<NgpFlip>;
     shift: Signal<NgpShift>;
-    container: Signal<string | HTMLElement | null>;
+    container: WritableSignal<string | HTMLElement | null>;
     open: Signal<boolean>;
     id: string;
     contentId: Signal<string | undefined>;
@@ -737,6 +744,7 @@ declare const NgpNavigationMenuTriggerStateToken: _angular_core.InjectionToken<_
     focusFirstContentItem: (retryCount?: number) => void;
     focusLastContentItem: (retryCount?: number) => void;
     setContentId: (newId: string) => void;
+    setContainer: (newContainer: HTMLElement | string | null) => void;
     setPointerOverContent: (isOver: boolean) => void;
     setFocusInsideContent: (isFocused: boolean) => void;
     registerContentFocusFunctions: (focusFirst: () => void, focusLast: () => void) => void;
@@ -748,7 +756,7 @@ declare const ngpNavigationMenuTrigger: ({ content: _content, disabled: _disable
     offset: Signal<NgpOffset>;
     flip: Signal<NgpFlip>;
     shift: Signal<NgpShift>;
-    container: Signal<string | HTMLElement | null>;
+    container: WritableSignal<string | HTMLElement | null>;
     open: Signal<boolean>;
     id: string;
     contentId: Signal<string | undefined>;
@@ -757,6 +765,7 @@ declare const ngpNavigationMenuTrigger: ({ content: _content, disabled: _disable
     focusFirstContentItem: (retryCount?: number) => void;
     focusLastContentItem: (retryCount?: number) => void;
     setContentId: (newId: string) => void;
+    setContainer: (newContainer: HTMLElement | string | null) => void;
     setPointerOverContent: (isOver: boolean) => void;
     setFocusInsideContent: (isFocused: boolean) => void;
     registerContentFocusFunctions: (focusFirst: () => void, focusLast: () => void) => void;
@@ -769,7 +778,7 @@ declare const injectNavigationMenuTriggerState: {
         offset: Signal<NgpOffset>;
         flip: Signal<NgpFlip>;
         shift: Signal<NgpShift>;
-        container: Signal<string | HTMLElement | null>;
+        container: WritableSignal<string | HTMLElement | null>;
         open: Signal<boolean>;
         id: string;
         contentId: Signal<string | undefined>;
@@ -778,6 +787,7 @@ declare const injectNavigationMenuTriggerState: {
         focusFirstContentItem: (retryCount?: number) => void;
         focusLastContentItem: (retryCount?: number) => void;
         setContentId: (newId: string) => void;
+        setContainer: (newContainer: HTMLElement | string | null) => void;
         setPointerOverContent: (isOver: boolean) => void;
         setFocusInsideContent: (isFocused: boolean) => void;
         registerContentFocusFunctions: (focusFirst: () => void, focusLast: () => void) => void;
@@ -789,7 +799,7 @@ declare const injectNavigationMenuTriggerState: {
         offset: Signal<NgpOffset>;
         flip: Signal<NgpFlip>;
         shift: Signal<NgpShift>;
-        container: Signal<string | HTMLElement | null>;
+        container: WritableSignal<string | HTMLElement | null>;
         open: Signal<boolean>;
         id: string;
         contentId: Signal<string | undefined>;
@@ -798,6 +808,7 @@ declare const injectNavigationMenuTriggerState: {
         focusFirstContentItem: (retryCount?: number) => void;
         focusLastContentItem: (retryCount?: number) => void;
         setContentId: (newId: string) => void;
+        setContainer: (newContainer: HTMLElement | string | null) => void;
         setPointerOverContent: (isOver: boolean) => void;
         setFocusInsideContent: (isFocused: boolean) => void;
         registerContentFocusFunctions: (focusFirst: () => void, focusLast: () => void) => void;
@@ -809,7 +820,7 @@ declare const injectNavigationMenuTriggerState: {
         offset: Signal<NgpOffset>;
         flip: Signal<NgpFlip>;
         shift: Signal<NgpShift>;
-        container: Signal<string | HTMLElement | null>;
+        container: WritableSignal<string | HTMLElement | null>;
         open: Signal<boolean>;
         id: string;
         contentId: Signal<string | undefined>;
@@ -818,6 +829,7 @@ declare const injectNavigationMenuTriggerState: {
         focusFirstContentItem: (retryCount?: number) => void;
         focusLastContentItem: (retryCount?: number) => void;
         setContentId: (newId: string) => void;
+        setContainer: (newContainer: HTMLElement | string | null) => void;
         setPointerOverContent: (isOver: boolean) => void;
         setFocusInsideContent: (isFocused: boolean) => void;
         registerContentFocusFunctions: (focusFirst: () => void, focusLast: () => void) => void;
@@ -828,7 +840,7 @@ declare const injectNavigationMenuTriggerState: {
         offset: Signal<NgpOffset>;
         flip: Signal<NgpFlip>;
         shift: Signal<NgpShift>;
-        container: Signal<string | HTMLElement | null>;
+        container: WritableSignal<string | HTMLElement | null>;
         open: Signal<boolean>;
         id: string;
         contentId: Signal<string | undefined>;
@@ -837,6 +849,7 @@ declare const injectNavigationMenuTriggerState: {
         focusFirstContentItem: (retryCount?: number) => void;
         focusLastContentItem: (retryCount?: number) => void;
         setContentId: (newId: string) => void;
+        setContainer: (newContainer: HTMLElement | string | null) => void;
         setPointerOverContent: (isOver: boolean) => void;
         setFocusInsideContent: (isFocused: boolean) => void;
         registerContentFocusFunctions: (focusFirst: () => void, focusLast: () => void) => void;

package/types/ng-primitives-popover.d.ts

@@ -159,7 +159,7 @@ interface NgpPopoverTriggerState<T> {
      * Define the container in which the popover should be attached.
      * @default document.body
      */
-    readonly container: Signal<HTMLElement | string | null>;
+    readonly container: WritableSignal<HTMLElement | string | null>;
     /**
      * Define whether the popover should close when clicking outside of it, or a guard function.
      * @default true
@@ -209,6 +209,13 @@ interface NgpPopoverTriggerState<T> {
     readonly open: Signal<boolean>;
     /** @internal onDestroy callback */
     destroy: () => void;
+    /**
+     * Set the container in which the popover should be attached. Takes effect the
+     * next time the popover is opened; it does not move a popover that is already
+     * open.
+     * @param container - The new container
+     */
+    setContainer: (container: HTMLElement | string | null) => void;
     /**
      * Show the popover.
      * @returns A promise that resolves when the popover has been shown
@@ -308,7 +315,7 @@ interface NgpPopoverTriggerProps<T> {
     readonly onOpenChange?: (value: boolean) => void;
 }
 declare const NgpPopoverTriggerStateToken: _angular_core.InjectionToken<WritableSignal<NgpPopoverTriggerState<unknown>>>;
-declare const ngpPopoverTrigger: <T>({ popover: _popover, disabled, placement, offset, showDelay, hideDelay, flip, shift, container, closeOnOutsideClick, closeOnEscape, scrollBehavior, context, anchor, trackPosition, cooldown, onOpenChange, }: NgpPopoverTriggerProps<T>) => NgpPopoverTriggerState<T>;
+declare const ngpPopoverTrigger: <T>({ popover: _popover, disabled, placement, offset, showDelay, hideDelay, flip, shift, container: _container, closeOnOutsideClick, closeOnEscape, scrollBehavior, context, anchor, trackPosition, cooldown, onOpenChange, }: NgpPopoverTriggerProps<T>) => NgpPopoverTriggerState<T>;
 declare const providePopoverTriggerState: (opts?: {
     inherit?: boolean;
 }) => _angular_core.FactoryProvider;

package/types/ng-primitives-portal.d.ts

@@ -102,6 +102,12 @@ interface CooldownOverlay {
     hideImmediate(): void;
     /** Optional signal to mark the transition as instant due to cooldown */
     instantTransition?: WritableSignal<boolean>;
+    /**
+     * Optional check for whether this overlay is a descendant of the given overlay
+     * (i.e. its trigger is rendered within the other overlay's content). Used to
+     * keep an ancestor open when a nested overlay of the same type is activated.
+     */
+    isDescendantOf?(other: CooldownOverlay): boolean;
 }
 /**
  * Singleton service that tracks close timestamps and active overlays per overlay type.
@@ -112,6 +118,13 @@ interface CooldownOverlay {
  */
 declare class NgpOverlayCooldownManager {
     private readonly lastCloseTimestamps;
+    /**
+     * Active overlays per type, stored as a stack ordered oldest-first / topmost-last.
+     * Most types only ever hold a single overlay, but when an overlay is nested inside
+     * another of the same type (e.g. a popover whose trigger lives inside another
+     * popover) the child is pushed on top of its ancestor instead of evicting it.
+     * Closing the child then restores the ancestor as the active overlay.
+     */
     private readonly activeOverlays;
     /**
      * Record the close timestamp for an overlay type.
@@ -127,7 +140,14 @@ declare class NgpOverlayCooldownManager {
     isWithinCooldown(overlayType: string, duration: number): boolean;
     /**
      * Register an overlay as active for its type.
-     * Any existing overlay of the same type will be closed immediately.
+     *
+     * Any existing overlay of the same type is closed immediately so that only one
+     * overlay of each type is open at a time - *unless* it is an ancestor of the
+     * overlay being registered. A nested overlay (its trigger rendered inside an
+     * ancestor overlay's content) is stacked on top of its ancestor instead of
+     * evicting it, allowing legitimate nesting to coexist while sibling overlays
+     * still replace one another.
+     *
      * @param overlayType The type identifier for the overlay group
      * @param overlay The overlay instance
      * @param cooldown The cooldown duration - if > 0, enables instant transitions
@@ -629,6 +649,16 @@ declare class NgpOverlay<T = unknown> implements CooldownOverlay {
      * @internal
      */
     unregisterChildOverlay(child: NgpOverlay): void;
+    /**
+     * Determine whether this overlay is a descendant of the given overlay - i.e.
+     * its trigger is rendered within the other overlay's content. Walks the parent
+     * overlay chain established through dependency injection.
+     *
+     * Used by the cooldown manager to avoid evicting an ancestor overlay when a
+     * nested overlay of the same type is activated.
+     * @internal
+     */
+    isDescendantOf(other: CooldownOverlay): boolean;
     /**
      * Check if the event path includes any child overlay elements (recursively).
      * @internal

package/types/ng-primitives-select.d.ts

@@ -229,7 +229,7 @@ interface NgpSelectState<T> {
     /** The position of the dropdown. */
     readonly placement: Signal<Placement>;
     /** The container for the dropdown. */
-    readonly container: Signal<HTMLElement | string | null>;
+    readonly container: WritableSignal<HTMLElement | string | null>;
     /** Whether the dropdown should flip when there is not enough space. Can be a boolean to enable/disable, or an object with padding and fallbackPlacements options. */
     readonly flip: Signal<NgpFlip>;
     /**
@@ -381,6 +381,13 @@ interface NgpSelectState<T> {
      * `setDisabledState` integration.
      */
     setDisabled(disabled: boolean): void;
+    /**
+     * Set the container in which the dropdown should be attached. Takes effect the
+     * next time the dropdown is opened; it does not move a dropdown that is already
+     * open.
+     * @param container - The new container
+     */
+    setContainer(container: HTMLElement | string | null): void;
     /**
      * Observable that emits whenever the value changes.
      */
@@ -427,7 +434,7 @@ interface NgpSelectProps<T> {
     readonly allOptions?: Signal<T[] | undefined>;
 }
 declare const NgpSelectStateToken: _angular_core.InjectionToken<WritableSignal<NgpSelectState<unknown>>>;
-declare const ngpSelect: <T>({ id, value: _value, multiple, disabled: _disabled, compareWith, placement, container, flip, offset, scrollToOption, allOptions, onValueChange, onOpenChange, }: NgpSelectProps<T>) => NgpSelectState<T>;
+declare const ngpSelect: <T>({ id, value: _value, multiple, disabled: _disabled, compareWith, placement, container: _container, flip, offset, scrollToOption, allOptions, onValueChange, onOpenChange, }: NgpSelectProps<T>) => NgpSelectState<T>;
 declare const provideSelectState: (opts?: {
     inherit?: boolean;
 }) => _angular_core.FactoryProvider;

package/types/ng-primitives-toast.d.ts

@@ -48,6 +48,7 @@ interface NgpToastOptions$1 {
 declare class NgpToast {
     private readonly manager;
     private readonly injector;
+    private readonly elementRef;
     protected readonly config: ng_primitives_toast.NgpToastConfig;
     /** @internal */
     readonly options: NgpToastOptions$1;
@@ -108,9 +109,9 @@ declare class NgpToast {
      */
     private readonly timer;
     constructor();
-    protected onPointerDown(event: PointerEvent): void;
-    protected onPointerMove(event: PointerEvent): void;
-    protected onPointerUp(): void;
+    private onPointerDown;
+    private onPointerMove;
+    private onPointerUp;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgpToast, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgpToast, "[ngpToast]", ["ngpToast"], {}, {}, never, never, true, never>;
 }