@radix-ng/primitives 1.0.0-beta.3 → 1.0.0-beta.5

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

@@ -1,13 +1,13 @@
 import * as _angular_core from '@angular/core';
-import { TemplateRef, Signal, ElementRef } from '@angular/core';
+import { TemplateRef, Signal } from '@angular/core';
 import * as i1 from '@radix-ng/primitives/portal';
 import * as _radix_ng_primitives_core from '@radix-ng/primitives/core';
-import { RdxTransitionStatus, BooleanInput, NumberInput } from '@radix-ng/primitives/core';
+import { RdxCancelableChangeEventDetails, RdxTransitionStatus, RdxFloatingRootContext, BooleanInput, NumberInput } from '@radix-ng/primitives/core';
 import * as i1$1 from '@radix-ng/primitives/popper';
-import { RdxPopperContentWrapper, RdxPopperAnchorElement } from '@radix-ng/primitives/popper';
+import { RdxPopperContentWrapper } from '@radix-ng/primitives/popper';
 import * as _radix_ng_primitives_navigation_menu from '@radix-ng/primitives/navigation-menu';
 import * as i1$2 from '@radix-ng/primitives/roving-focus';
-import * as i2 from '@radix-ng/primitives/dismissable-layer';
+import { RdxOutsidePressDomEvent } from '@radix-ng/primitives/dismissable-layer';
 
 /**
  * Structural directive that teleports the navigation menu popup into a container (default
@@ -36,12 +36,15 @@ declare class RdxNavigationMenuPortalMisuseGuard {
 
 type NavigationMenuOrientation = 'horizontal' | 'vertical';
 type NavigationMenuDirection = 'ltr' | 'rtl';
-type RdxNavigationMenuOpenChangeReason = 'trigger-hover' | 'trigger-focus' | 'trigger-press' | 'outside-press' | 'focus-out' | 'escape-key' | 'link-select' | 'list-leave' | 'none';
+type RdxNavigationMenuOpenChangeReason = 'trigger-hover' | 'trigger-focus' | 'trigger-press' | 'list-navigation' | 'outside-press' | 'focus-out' | 'escape-key' | 'link-select' | 'list-leave' | 'none';
+type RdxNavigationMenuOpenChangeEventDetails = RdxCancelableChangeEventDetails<RdxNavigationMenuOpenChangeReason>;
 interface RdxNavigationMenuOpenChange {
     value: string | null;
     open: boolean;
     reason: RdxNavigationMenuOpenChangeReason;
     event: Event;
+    trigger: HTMLElement | undefined;
+    eventDetails: RdxNavigationMenuOpenChangeEventDetails;
 }
 /**
  * A registered item content template, rendered into the shared viewport when its item is active.
@@ -65,6 +68,7 @@ interface RdxNavigationMenuRootContext {
     /** Value of the previously open item (used for slide-direction morphing). */
     readonly previousValue: Signal<string | null>;
     readonly isOpen: Signal<boolean>;
+    readonly present: Signal<boolean>;
     readonly instant: Signal<boolean>;
     readonly transitionStatus: Signal<RdxTransitionStatus>;
     /** The active trigger element the popup is anchored to. */
@@ -78,7 +82,7 @@ interface RdxNavigationMenuRootContext {
     close(reason?: RdxNavigationMenuOpenChangeReason, event?: Event): void;
     toggle(value: string, trigger: HTMLElement, event?: Event): void;
     openOnHover(value: string, trigger: HTMLElement, event: PointerEvent): void;
-    closeOnHover(): void;
+    closeOnHover(event?: PointerEvent): void;
     cancelHoverOpen(): void;
     cancelHoverClose(): void;
     registerTrigger(value: string, trigger: HTMLElement): () => void;
@@ -100,6 +104,9 @@ declare class RdxNavigationMenuRoot {
     private readonly popper;
     private readonly destroyRef;
     private readonly parentRoot;
+    private readonly registration;
+    /** Per-popup floating root context (ADR 0015) — `open` / `triggers` / reference for the dismissal engine. */
+    readonly floatingContext: RdxFloatingRootContext;
     /** Whether this root is nested inside another navigation menu's content. */
     readonly nested: boolean;
     readonly baseId: string;
@@ -118,7 +125,8 @@ declare class RdxNavigationMenuRoot {
     /**
      * The reading direction of the navigation menu.
      */
-    readonly dir: _angular_core.InputSignal<NavigationMenuDirection>;
+    readonly dirInput: _angular_core.InputSignal<NavigationMenuDirection | undefined>;
+    readonly dir: _angular_core.Signal<_radix_ng_primitives_core.Direction>;
     /**
      * Whether keyboard navigation loops from the last item back to the first and vice versa.
      */
@@ -152,6 +160,8 @@ declare class RdxNavigationMenuRoot {
     readonly transitionStatus: _angular_core.Signal<_radix_ng_primitives_core.RdxTransitionStatus>;
     readonly previousValue: _angular_core.WritableSignal<string | null>;
     readonly isOpen: _angular_core.Signal<boolean>;
+    private readonly preventUnmountOnClose;
+    readonly present: _angular_core.Signal<boolean>;
     readonly trigger: _angular_core.WritableSignal<HTMLElement | undefined>;
     readonly triggers: _angular_core.WritableSignal<HTMLElement[]>;
     readonly contents: _angular_core.WritableSignal<Map<string, RdxNavigationMenuContentEntry>>;
@@ -166,19 +176,21 @@ declare class RdxNavigationMenuRoot {
     close(reason?: RdxNavigationMenuOpenChangeReason, event?: Event): void;
     toggle(value: string, trigger: HTMLElement, event?: Event): void;
     openOnHover(value: string, trigger: HTMLElement, event: PointerEvent): void;
-    closeOnHover(): void;
+    closeOnHover(event?: PointerEvent): void;
     cancelHoverOpen(): void;
     cancelHoverClose(): void;
     registerTrigger(value: string, trigger: HTMLElement): () => void;
     registerContent(entry: RdxNavigationMenuContentEntry): () => void;
     registerTransitionElement(element: HTMLElement): () => void;
     registerViewport(onTriggerChange: (previous: HTMLElement, next: HTMLElement) => void): () => boolean;
+    private createOpenChangeEvent;
     private scheduleInstantReset;
     private clearHoverTimers;
     private clearOpenTimer;
     private clearCloseTimer;
+    private isInsideOpenChild;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxNavigationMenuRoot, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxNavigationMenuRoot, "[rdxNavigationMenuRoot]", ["rdxNavigationMenuRoot"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "defaultValue": { "alias": "defaultValue"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "dir": { "alias": "dir"; "required": false; "isSignal": true; }; "loop": { "alias": "loop"; "required": false; "isSignal": true; }; "delay": { "alias": "delay"; "required": false; "isSignal": true; }; "closeDelay": { "alias": "closeDelay"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "onValueChange": "onValueChange"; "onOpenChange": "onOpenChange"; "onOpenChangeComplete": "onOpenChangeComplete"; }, never, never, true, [{ directive: typeof i1$1.RdxPopper; inputs: {}; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxNavigationMenuRoot, "[rdxNavigationMenuRoot]", ["rdxNavigationMenuRoot"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "defaultValue": { "alias": "defaultValue"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "dirInput": { "alias": "dir"; "required": false; "isSignal": true; }; "loop": { "alias": "loop"; "required": false; "isSignal": true; }; "delay": { "alias": "delay"; "required": false; "isSignal": true; }; "closeDelay": { "alias": "closeDelay"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "onValueChange": "onValueChange"; "onOpenChange": "onOpenChange"; "onOpenChangeComplete": "onOpenChangeComplete"; }, never, never, true, [{ directive: typeof i1$1.RdxPopper; inputs: {}; outputs: {}; }, { directive: typeof _radix_ng_primitives_core.RdxFloatingNodeRegistration; inputs: {}; outputs: {}; }]>;
 }
 
 /**
@@ -322,69 +334,21 @@ declare class RdxNavigationMenuBackdrop {
 
 /**
  * Positions the shared popup against the active trigger.
+ *
+ * A "thin" positioner (ADR 0012): it inherits the popper positioning surface (inputs, `placed`
+ * output, unified vars + placement attrs) from {@link RdxPopperContentWrapper} and adds the
+ * navigation-menu defaults, the open/closed/instant state attributes, and the grace-area hover
+ * bridge. It exposes no legacy `--radix-*` aliases.
  */
-declare class RdxNavigationMenuPositioner {
+declare class RdxNavigationMenuPositioner extends RdxPopperContentWrapper {
     protected readonly rootContext: _radix_ng_primitives_navigation_menu.RdxNavigationMenuRootContext;
-    protected readonly wrapper: RdxPopperContentWrapper;
-    private readonly elementRef;
+    private readonly containerRef;
     private readonly triggerEl;
     private readonly containerEl;
     private readonly graceArea;
-    /**
-     * An element to position the popup against. Defaults to the active trigger.
-     */
-    readonly anchor: _angular_core.InputSignal<RdxPopperAnchorElement>;
-    /**
-     * The preferred side of the trigger to render against when open.
-     */
-    readonly side: _angular_core.InputSignal<"top" | "right" | "bottom" | "left">;
-    /**
-     * Distance between the trigger and the popup in pixels.
-     */
-    readonly sideOffset: _angular_core.InputSignalWithTransform<number, NumberInput>;
-    /**
-     * How to align the popup relative to the specified side.
-     */
-    readonly align: _angular_core.InputSignal<"start" | "center" | "end">;
-    /**
-     * An offset in pixels from the `start` or `end` alignment options.
-     */
-    readonly alignOffset: _angular_core.InputSignalWithTransform<number, NumberInput>;
-    /**
-     * Minimum distance to maintain between the arrow and the edges of the popup.
-     */
-    readonly arrowPadding: _angular_core.InputSignalWithTransform<number, NumberInput>;
-    /**
-     * Whether to override side and alignment preferences to prevent collisions.
-     */
-    readonly avoidCollisions: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
-    /**
-     * The element used as the collision boundary.
-     */
-    readonly collisionBoundary: _angular_core.InputSignal<ElementRef<HTMLElement> | ElementRef<HTMLElement>[] | undefined>;
-    /**
-     * Distance in pixels from the boundary edges where collision detection should occur.
-     */
-    readonly collisionPadding: _angular_core.InputSignal<number | Partial<Record<"top" | "right" | "bottom" | "left", number>>>;
-    /**
-     * The sticky behavior on the alignment axis.
-     */
-    readonly sticky: _angular_core.InputSignal<"always" | "partial">;
-    /**
-     * Whether to hide the popup when the trigger becomes fully occluded.
-     */
-    readonly hideWhenDetached: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
-    /**
-     * The CSS position strategy used by Floating UI.
-     */
-    readonly positionStrategy: _angular_core.InputSignal<"fixed" | "absolute">;
-    /**
-     * Whether to update position on every animation frame.
-     */
-    readonly updatePositionStrategy: _angular_core.InputSignal<"always" | "optimized">;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxNavigationMenuPositioner, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxNavigationMenuPositioner, "[rdxNavigationMenuPositioner]", never, { "anchor": { "alias": "anchor"; "required": false; "isSignal": true; }; "side": { "alias": "side"; "required": false; "isSignal": true; }; "sideOffset": { "alias": "sideOffset"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "alignOffset": { "alias": "alignOffset"; "required": false; "isSignal": true; }; "arrowPadding": { "alias": "arrowPadding"; "required": false; "isSignal": true; }; "avoidCollisions": { "alias": "avoidCollisions"; "required": false; "isSignal": true; }; "collisionBoundary": { "alias": "collisionBoundary"; "required": false; "isSignal": true; }; "collisionPadding": { "alias": "collisionPadding"; "required": false; "isSignal": true; }; "sticky": { "alias": "sticky"; "required": false; "isSignal": true; }; "hideWhenDetached": { "alias": "hideWhenDetached"; "required": false; "isSignal": true; }; "positionStrategy": { "alias": "positionStrategy"; "required": false; "isSignal": true; }; "updatePositionStrategy": { "alias": "updatePositionStrategy"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1$1.RdxPopperContentWrapper; inputs: { "anchor": "anchor"; "side": "side"; "sideOffset": "sideOffset"; "align": "align"; "alignOffset": "alignOffset"; "arrowPadding": "arrowPadding"; "avoidCollisions": "avoidCollisions"; "collisionBoundary": "collisionBoundary"; "collisionPadding": "collisionPadding"; "sticky": "sticky"; "hideWhenDetached": "hideWhenDetached"; "positionStrategy": "positionStrategy"; "updatePositionStrategy": "updatePositionStrategy"; }; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxNavigationMenuPositioner, "[rdxNavigationMenuPositioner]", never, {}, {}, never, never, true, never>;
 }
 
 /**
@@ -392,38 +356,36 @@ declare class RdxNavigationMenuPositioner {
  */
 declare class RdxNavigationMenuPopup {
     protected readonly rootContext: _radix_ng_primitives_navigation_menu.RdxNavigationMenuRootContext;
-    private readonly dismissableLayer;
+    private readonly floatingContext;
+    private readonly registration;
     private readonly wrapper;
-    private readonly layersContext;
     private readonly elementRef;
     protected readonly side: _angular_core.Signal<"top" | "right" | "bottom" | "left" | undefined>;
     protected readonly align: _angular_core.Signal<"start" | "center" | "end" | undefined>;
     /** Names the menu after the active trigger so the `role="menu"` element has an accessible name. */
     protected readonly labelledBy: _angular_core.Signal<string | undefined>;
-    private dismissReason;
-    private dismissEvent;
     /**
      * Event handler called when the escape key is down. Can be prevented.
      */
-    readonly escapeKeyDown: _angular_core.OutputRef<KeyboardEvent>;
+    readonly escapeKeyDown: _angular_core.OutputEmitterRef<KeyboardEvent>;
     /**
      * Event handler called when a pointerdown event happens outside the popup. Can be prevented.
      */
-    readonly pointerDownOutside: _angular_core.OutputRef<PointerEvent>;
+    readonly pointerDownOutside: _angular_core.OutputEmitterRef<RdxOutsidePressDomEvent>;
     /**
      * Event handler called when focus moves outside the popup. Can be prevented.
      */
-    readonly focusOutside: _angular_core.OutputRef<FocusEvent>;
+    readonly focusOutside: _angular_core.OutputEmitterRef<FocusEvent>;
     constructor();
     protected onPointerLeave(event: PointerEvent): void;
     /**
      * Keyboard navigation inside the open panel: Down/Up move between the panel's focusable items in
      * DOM order, Home/End jump to the first/last, and Up from the first item returns focus to the
-     * trigger. (Tab keeps working natively; Escape is handled by the dismissable layer.)
+     * trigger. (Tab keeps working natively; Escape is handled by the dismissal capability.)
      */
     protected onKeydown(event: KeyboardEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxNavigationMenuPopup, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxNavigationMenuPopup, "[rdxNavigationMenuPopup]", never, {}, { "escapeKeyDown": "escapeKeyDown"; "pointerDownOutside": "pointerDownOutside"; "focusOutside": "focusOutside"; }, never, never, true, [{ directive: typeof i1$1.RdxPopperContent; inputs: {}; outputs: {}; }, { directive: typeof i2.RdxDismissableLayer; inputs: {}; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxNavigationMenuPopup, "[rdxNavigationMenuPopup]", never, {}, { "escapeKeyDown": "escapeKeyDown"; "pointerDownOutside": "pointerDownOutside"; "focusOutside": "focusOutside"; }, never, never, true, [{ directive: typeof i1$1.RdxPopperContent; inputs: {}; outputs: {}; }]>;
 }
 
 /**
@@ -483,4 +445,4 @@ declare class RdxNavigationMenuModule {
 }
 
 export { RdxNavigationMenuArrow, RdxNavigationMenuBackdrop, RdxNavigationMenuContent, RdxNavigationMenuIcon, RdxNavigationMenuItem, RdxNavigationMenuLink, RdxNavigationMenuList, RdxNavigationMenuModule, RdxNavigationMenuPopup, RdxNavigationMenuPortal, RdxNavigationMenuPortalMisuseGuard, RdxNavigationMenuPositioner, RdxNavigationMenuRoot, RdxNavigationMenuTrigger, RdxNavigationMenuViewport, injectNavigationMenuRootContext, navigationMenuImports, provideNavigationMenuRootContext };
-export type { NavigationMenuDirection, NavigationMenuOrientation, RdxNavigationMenuContentEntry, RdxNavigationMenuOpenChange, RdxNavigationMenuOpenChangeReason, RdxNavigationMenuRootContext };
+export type { NavigationMenuDirection, NavigationMenuOrientation, RdxNavigationMenuContentEntry, RdxNavigationMenuOpenChange, RdxNavigationMenuOpenChangeEventDetails, RdxNavigationMenuOpenChangeReason, RdxNavigationMenuRootContext };

package/types/radix-ng-primitives-number-field.d.ts

@@ -1,7 +1,7 @@
 import * as _angular_core from '@angular/core';
 import { Signal } from '@angular/core';
 import * as _radix_ng_primitives_core from '@radix-ng/primitives/core';
-import { RdxFormValueControl, RdxControlValueAccessor, NumberInput, BooleanInput } from '@radix-ng/primitives/core';
+import { RdxFormValueControl, RdxControlValueAccessor, NumberInput, BooleanInput, RdxCancelableChangeEventDetails } from '@radix-ng/primitives/core';
 import * as _radix_ng_primitives_number_field from '@radix-ng/primitives/number-field';
 import { NumberFormatter, NumberParser } from '@internationalized/number';
 import * as i1 from '@radix-ng/primitives/portal';
@@ -35,6 +35,11 @@ declare const REASONS: {
     readonly none: "none";
 };
 
+type RdxNumberFieldValueChangeEventDetails = RdxCancelableChangeEventDetails<NumberFieldChangeReason>;
+interface RdxNumberFieldValueChangeEvent {
+    value: number | null;
+    eventDetails: RdxNumberFieldValueChangeEventDetails;
+}
 /**
  * Groups all parts of the number field and manages its state, parsing/formatting
  * and value-change logic. A single directive drives the whole family — parts read
@@ -110,7 +115,7 @@ declare class RdxNumberFieldRoot implements RdxFormValueControl<number | null> {
     /** The controlled value of the field. Use with `(onValueChange)` or two-way `[(value)]`. */
     readonly value: _angular_core.ModelSignal<number | null>;
     /** Emitted when the value changes (during interaction or programmatically). */
-    readonly onValueChange: _angular_core.OutputEmitterRef<number | null>;
+    readonly onValueChange: _angular_core.OutputEmitterRef<RdxNumberFieldValueChangeEvent>;
     /**
      * Emitted when the value is committed: on blur after typing, or when a pointer is released
      * after scrubbing or pressing a button. Fires together with `onValueChange` for keyboard input.
@@ -461,4 +466,4 @@ declare class RdxNumberFieldModule {
 }
 
 export { CHANGE_VALUE_TICK_DELAY, DEFAULT_STEP, REASONS, RdxNumberFieldButton, RdxNumberFieldDecrement, RdxNumberFieldGroup, RdxNumberFieldHiddenInput, RdxNumberFieldIncrement, RdxNumberFieldInput, RdxNumberFieldModule, RdxNumberFieldRoot, RdxNumberFieldScrubArea, RdxNumberFieldScrubAreaCursor, SCROLLING_POINTER_MOVE_DISTANCE, START_AUTO_CHANGE_DELAY, createPressAndHold, hasNumberFormatRoundingOptions, injectNumberFieldRootContext, injectNumberFieldScrubAreaContext, numberOrUndefined, provideNumberFieldRootContext, provideNumberFieldScrubAreaContext, removeFloatingPointErrors, toValidatedNumber, useNumberFormatter, useNumberParser };
-export type { Direction, InputMode, NumberFieldChangeReason, PressAndHold, PressAndHoldOptions, RdxNumberFieldScrubAreaContext, ValidateOptions };
+export type { Direction, InputMode, NumberFieldChangeReason, PressAndHold, PressAndHoldOptions, RdxNumberFieldScrubAreaContext, RdxNumberFieldValueChangeEvent, RdxNumberFieldValueChangeEventDetails, ValidateOptions };

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

@@ -2,12 +2,13 @@ import * as _angular_core from '@angular/core';
 import { Signal, ElementRef } from '@angular/core';
 import * as i1 from '@radix-ng/primitives/portal';
 import * as _radix_ng_primitives_core from '@radix-ng/primitives/core';
-import { RdxTransitionStatus, BooleanInput, NumberInput } from '@radix-ng/primitives/core';
+import { RdxTransitionStatus, RdxFloatingRootContext, BooleanInput, RdxCancelableChangeEventDetails, NumberInput } from '@radix-ng/primitives/core';
+import * as _radix_ng_primitives_floating_focus_manager from '@radix-ng/primitives/floating-focus-manager';
+import { RdxInteractionType } from '@radix-ng/primitives/floating-focus-manager';
 import * as i1$1 from '@radix-ng/primitives/popper';
-import { RdxPopperContentWrapper, RdxPopperAnchorElement } from '@radix-ng/primitives/popper';
+import { RdxPopperContentWrapper } from '@radix-ng/primitives/popper';
 import * as _radix_ng_primitives_popover from '@radix-ng/primitives/popover';
-import * as i2 from '@radix-ng/primitives/dismissable-layer';
-import * as i3 from '@radix-ng/primitives/focus-scope';
+import { RdxOutsidePressDomEvent } from '@radix-ng/primitives/dismissable-layer';
 
 /**
  * Structural directive that teleports the popover content into a container (default `document.body`)
@@ -48,17 +49,20 @@ declare function createRdxPopoverHandle<Payload = unknown>(): RdxPopoverHandle<P
 
 type RdxPopoverModal = boolean | 'trap-focus';
 type RdxPopoverOpenChangeReason = 'trigger-hover' | 'trigger-focus' | 'trigger-press' | 'outside-press' | 'escape-key' | 'close-press' | 'focus-out' | 'imperative-action' | 'none';
+type RdxPopoverOpenChangeEventDetails = RdxCancelableChangeEventDetails<RdxPopoverOpenChangeReason>;
 interface RdxPopoverOpenChange {
     open: boolean;
     triggerId: string | null;
     trigger: HTMLElement | undefined;
     reason: RdxPopoverOpenChangeReason;
     event: Event;
+    eventDetails: RdxPopoverOpenChangeEventDetails;
 }
 interface RdxPopoverRootContext {
     contentId: string;
     descriptionId: Signal<string | undefined>;
     isOpen: Signal<boolean>;
+    present: Signal<boolean>;
     modal: Signal<RdxPopoverModal>;
     titleId: Signal<string | undefined>;
     trigger: Signal<HTMLElement | undefined>;
@@ -68,6 +72,10 @@ interface RdxPopoverRootContext {
     instant: Signal<boolean>;
     openChangeReason: Signal<RdxPopoverOpenChangeReason>;
     isPointerDownOnTrigger: Signal<boolean>;
+    /** Whether the current open was initiated by touch (ADR 0016 §3 — gates the anchored scroll lock). */
+    openedByTouch: Signal<boolean>;
+    openInteractionType: Signal<RdxInteractionType>;
+    closeInteractionType: Signal<RdxInteractionType>;
     close: (reason?: RdxPopoverOpenChangeReason, event?: Event) => void;
     cancelHoverClose: () => void;
     cancelHoverOpen: () => void;
@@ -79,11 +87,15 @@ interface RdxPopoverRootContext {
     setDescriptionId: (id: string | undefined) => void;
     setTitleId: (id: string | undefined) => void;
     setPointerDownOnTrigger: (pointerDown: boolean) => void;
+    setOpenedByTouch: (value: boolean) => void;
+    setTriggerOpenInteractionType: (type: RdxInteractionType) => void;
     setHoverDelays: (delay: number, closeDelay: number) => void;
     registerPopupClose: () => () => void;
     registerTransitionElement: (element: HTMLElement) => () => void;
     transitionStatus: Signal<RdxPopoverTransitionStatus>;
+    beforeContentFocusGuard: Signal<HTMLElement | null>;
     registerViewport: (onTriggerChange: (previous: HTMLElement, next: HTMLElement) => void) => () => void;
+    setBeforeContentFocusGuard: (element: HTMLElement | null) => void;
     toggle: (triggerId: string, trigger: HTMLElement, payload?: unknown, event?: Event) => void;
 }
 declare const injectRdxPopoverRootContext: _radix_ng_primitives_core.InjectContext<RdxPopoverRootContext>;
@@ -95,6 +107,8 @@ type RdxPopoverTransitionStatus = RdxTransitionStatus;
 declare class RdxPopoverRoot {
     private readonly popper;
     private readonly destroyRef;
+    /** Shared per-popup floating context (ADR 0015 §1): `open`, trigger registry, reference / floating els. */
+    readonly floatingContext: RdxFloatingRootContext;
     private hasAppliedDefaultOpen;
     private hasAppliedDefaultTriggerId;
     private openTimer;
@@ -132,18 +146,26 @@ declare class RdxPopoverRoot {
      */
     readonly handle: _angular_core.InputSignal<RdxPopoverHandle<any> | undefined>;
     readonly contentId: string;
+    readonly beforeContentFocusGuard: _angular_core.WritableSignal<HTMLElement | null>;
     readonly descriptionId: _angular_core.WritableSignal<string | undefined>;
     readonly titleId: _angular_core.WritableSignal<string | undefined>;
     readonly trigger: _angular_core.WritableSignal<HTMLElement | undefined>;
     readonly triggers: _angular_core.WritableSignal<HTMLElement[]>;
     readonly payload: _angular_core.WritableSignal<unknown>;
     readonly isPointerDownOnTrigger: _angular_core.WritableSignal<boolean>;
+    /** Whether the current open was initiated by touch (ADR 0016 §3 — gates the anchored scroll lock). */
+    readonly openedByTouch: _angular_core.WritableSignal<boolean>;
+    readonly openInteractionType: _angular_core.WritableSignal<RdxInteractionType>;
+    readonly closeInteractionType: _angular_core.WritableSignal<RdxInteractionType>;
     readonly popupCloseCount: _angular_core.WritableSignal<number>;
+    private readonly preventUnmountOnClose;
+    private readonly pendingTriggerOpenInteractionType;
     readonly onOpenChange: _angular_core.OutputEmitterRef<RdxPopoverOpenChange>;
     readonly onOpenChangeComplete: _angular_core.OutputEmitterRef<boolean>;
     private readonly registeredTriggers;
     private readonly viewportTriggerChange;
     readonly state: Signal<"open" | "closed">;
+    readonly present: Signal<boolean>;
     constructor();
     show(trigger?: HTMLElement | undefined, payload?: unknown, triggerId?: string, reason?: RdxPopoverOpenChangeReason, event?: Event, fromHover?: boolean): void;
     close(reason?: RdxPopoverOpenChangeReason, event?: Event): void;
@@ -153,15 +175,18 @@ declare class RdxPopoverRoot {
     cancelHoverClose(): void;
     cancelHoverOpen(): void;
     setHoverDelays(delay: number, closeDelay: number): void;
+    setTriggerOpenInteractionType(type: RdxInteractionType): void;
     registerTrigger(id: string, trigger: HTMLElement, payload: () => unknown): () => void;
     registerViewport(onTriggerChange: (previous: HTMLElement, next: HTMLElement) => void): () => boolean;
+    setBeforeContentFocusGuard(element: HTMLElement | null): void;
     registerTransitionElement(element: HTMLElement): () => void;
     private syncTriggerId;
-    private emitOpenChange;
+    private createOpenChangeEvent;
     private clearHoverTimers;
     private clearOpenTimer;
     private clearCloseTimer;
     private scheduleInstantReset;
+    private consumeOpenInteractionType;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxPopoverRoot, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxPopoverRoot, "[rdxPopoverRoot]", ["rdxPopoverRoot"], { "open": { "alias": "open"; "required": false; "isSignal": true; }; "defaultOpen": { "alias": "defaultOpen"; "required": false; "isSignal": true; }; "triggerId": { "alias": "triggerId"; "required": false; "isSignal": true; }; "defaultTriggerId": { "alias": "defaultTriggerId"; "required": false; "isSignal": true; }; "modal": { "alias": "modal"; "required": false; "isSignal": true; }; "handle": { "alias": "handle"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "triggerId": "triggerIdChange"; "onOpenChange": "onOpenChange"; "onOpenChangeComplete": "onOpenChangeComplete"; }, never, never, true, [{ directive: typeof i1$1.RdxPopper; inputs: {}; outputs: {}; }]>;
 }
@@ -203,13 +228,14 @@ declare class RdxPopoverTrigger {
     protected readonly triggerId: _angular_core.Signal<string>;
     protected readonly rootContext: _angular_core.Signal<_radix_ng_primitives_popover.RdxPopoverRootContext | null>;
     protected readonly isOpen: _angular_core.Signal<boolean>;
+    protected readonly triggerInteraction: _radix_ng_primitives_floating_focus_manager.RdxTriggerInteraction;
     protected readonly isPressed: _angular_core.Signal<boolean>;
     private readonly generatedId;
     constructor();
     protected handleClick(event: MouseEvent): void;
     protected handlePointerEnter(event: PointerEvent): void;
     protected handlePointerLeave(event: PointerEvent): void;
-    protected handlePointerDown(): void;
+    protected handlePointerDown(event: PointerEvent): void;
     protected handlePointerUp(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxPopoverTrigger, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxPopoverTrigger, "button[rdxPopoverTrigger]", never, { "handle": { "alias": "handle"; "required": false; "isSignal": true; }; "payload": { "alias": "payload"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "openOnHover": { "alias": "openOnHover"; "required": false; "isSignal": true; }; "delay": { "alias": "delay"; "required": false; "isSignal": true; }; "closeDelay": { "alias": "closeDelay"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1$1.RdxPopperAnchor; inputs: {}; outputs: {}; }]>;
@@ -220,119 +246,72 @@ declare class RdxPopoverTrigger {
  */
 declare class RdxPopoverBackdrop {
     protected readonly rootContext: _radix_ng_primitives_popover.RdxPopoverRootContext;
+    constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxPopoverBackdrop, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxPopoverBackdrop, "[rdxPopoverBackdrop]", never, {}, {}, never, never, true, never>;
 }
 
 /**
  * Positions the popover against its trigger.
+ *
+ * A "thin" positioner (ADR 0012): it inherits the popper positioning surface (inputs, `placed`
+ * output, unified vars + placement attrs) from {@link RdxPopperContentWrapper} and adds popover's own
+ * concerns — Base UI-aligned defaults via the config provider, the open/closed/instant state
+ * attributes, the deprecated `--radix-popover-*` aliases, and the grace-area hover bridge.
  */
-declare class RdxPopoverPositioner {
+declare class RdxPopoverPositioner extends RdxPopperContentWrapper {
     protected readonly rootContext: _radix_ng_primitives_popover.RdxPopoverRootContext;
-    protected readonly wrapper: RdxPopperContentWrapper;
-    private readonly elementRef;
+    protected readonly legacyVars: Record<string, string>;
+    private readonly containerRef;
     private readonly triggerEl;
     private readonly containerEl;
     private readonly graceArea;
-    /**
-     * An element to position the popup against. Defaults to the trigger.
-     */
-    readonly anchor: _angular_core.InputSignal<RdxPopperAnchorElement>;
-    /**
-     * The preferred side of the trigger to render against when open.
-     */
-    readonly side: _angular_core.InputSignal<"top" | "right" | "bottom" | "left">;
-    /**
-     * Distance between the trigger and the popup in pixels.
-     */
-    readonly sideOffset: _angular_core.InputSignalWithTransform<number, NumberInput>;
-    /**
-     * How to align the popup relative to the specified side.
-     */
-    readonly align: _angular_core.InputSignal<"start" | "center" | "end">;
-    /**
-     * An offset in pixels from the `start` or `end` alignment options.
-     */
-    readonly alignOffset: _angular_core.InputSignalWithTransform<number, NumberInput>;
-    /**
-     * Minimum distance to maintain between the arrow and the edges of the popup.
-     */
-    readonly arrowPadding: _angular_core.InputSignalWithTransform<number, NumberInput>;
-    /**
-     * Whether to override side and alignment preferences to prevent collisions.
-     */
-    readonly avoidCollisions: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
-    /**
-     * The element used as the collision boundary.
-     */
-    readonly collisionBoundary: _angular_core.InputSignal<ElementRef<HTMLElement> | ElementRef<HTMLElement>[] | undefined>;
-    /**
-     * Distance in pixels from the boundary edges where collision detection should occur.
-     */
-    readonly collisionPadding: _angular_core.InputSignal<number | Partial<Record<"top" | "right" | "bottom" | "left", number>>>;
-    /**
-     * The sticky behavior on the alignment axis.
-     */
-    readonly sticky: _angular_core.InputSignal<"always" | "partial">;
-    /**
-     * Whether to hide the popup when the trigger becomes fully occluded.
-     */
-    readonly hideWhenDetached: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
-    /**
-     * The CSS position strategy used by Floating UI.
-     */
-    readonly positionStrategy: _angular_core.InputSignal<"fixed" | "absolute">;
-    /**
-     * Whether to update position on every animation frame.
-     */
-    readonly updatePositionStrategy: _angular_core.InputSignal<"always" | "optimized">;
-    /**
-     * Emits when the popup has been placed.
-     */
-    readonly placed: _angular_core.OutputRef<void>;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxPopoverPositioner, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxPopoverPositioner, "[rdxPopoverPositioner]", never, { "anchor": { "alias": "anchor"; "required": false; "isSignal": true; }; "side": { "alias": "side"; "required": false; "isSignal": true; }; "sideOffset": { "alias": "sideOffset"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "alignOffset": { "alias": "alignOffset"; "required": false; "isSignal": true; }; "arrowPadding": { "alias": "arrowPadding"; "required": false; "isSignal": true; }; "avoidCollisions": { "alias": "avoidCollisions"; "required": false; "isSignal": true; }; "collisionBoundary": { "alias": "collisionBoundary"; "required": false; "isSignal": true; }; "collisionPadding": { "alias": "collisionPadding"; "required": false; "isSignal": true; }; "sticky": { "alias": "sticky"; "required": false; "isSignal": true; }; "hideWhenDetached": { "alias": "hideWhenDetached"; "required": false; "isSignal": true; }; "positionStrategy": { "alias": "positionStrategy"; "required": false; "isSignal": true; }; "updatePositionStrategy": { "alias": "updatePositionStrategy"; "required": false; "isSignal": true; }; }, { "placed": "placed"; }, never, never, true, [{ directive: typeof i1$1.RdxPopperContentWrapper; inputs: { "anchor": "anchor"; "side": "side"; "sideOffset": "sideOffset"; "align": "align"; "alignOffset": "alignOffset"; "arrowPadding": "arrowPadding"; "avoidCollisions": "avoidCollisions"; "collisionBoundary": "collisionBoundary"; "collisionPadding": "collisionPadding"; "sticky": "sticky"; "hideWhenDetached": "hideWhenDetached"; "positionStrategy": "positionStrategy"; "updatePositionStrategy": "updatePositionStrategy"; }; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxPopoverPositioner, "[rdxPopoverPositioner]", never, {}, {}, never, never, true, never>;
 }
 
 /**
  * A container for the popover contents.
+ *
+ * **ADR 0015/0017 Phase-4 migration** onto the new floating dismissal + focus engine (same pattern as
+ * Dialog; browser-verified via `popover.behavior` Playwright). Popover-specific:
+ * - **Hover-open disables the manager** (`enabled = isOpen && !isHoverActive`) — Base UI parity
+ *   (`disabled={!mounted || openReason === triggerHover}`); a hover-opened popover does not trap / mark.
+ *   (The legacy only suppressed auto-focus while still trapping — that Radix divergence is dropped.)
+ * - Trap = `'trap-focus' || (modal === true && hasPopupClose())`; scroll lock + real outside `inert`
+ *   isolation key off the full modal (`modal === true`).
+ * - No `disablePointerDismissal` — outside-press + focus-out always close.
+ *
+ * Note: a positioned popover does **not** auto-focus into the popup on open (pre-existing — the legacy
+ * behaved the same; verified). The trap holds focus once it is inside; portal tab-order handoff is owned
+ * by `RdxFloatingFocusManager` and anchored to the active trigger below.
  */
 declare class RdxPopoverPopup {
     protected readonly rootContext: _radix_ng_primitives_popover.RdxPopoverRootContext;
-    private readonly dismissableLayer;
+    private readonly host;
+    private readonly floatingContext;
+    private readonly registration;
+    private readonly focusManager;
     private readonly focusScope;
     private readonly wrapper;
     protected readonly align: _angular_core.Signal<"start" | "center" | "end" | undefined>;
     protected readonly side: _angular_core.Signal<"top" | "right" | "bottom" | "left" | undefined>;
-    private dismissDetails;
-    /**
-     * Event handler called when the escape key is down. Can be prevented.
-     */
-    readonly escapeKeyDown: _angular_core.OutputRef<KeyboardEvent>;
-    /**
-     * Event handler called when a pointerdown event happens outside of the popup. Can be prevented.
-     */
-    readonly pointerDownOutside: _angular_core.OutputRef<PointerEvent>;
-    /**
-     * Event handler called when focus moves outside of the popup. Can be prevented.
-     */
-    readonly focusOutside: _angular_core.OutputRef<FocusEvent>;
-    /**
-     * Event handler called when an interaction happens outside of the popup. Can be prevented.
-     */
-    readonly interactOutside: _angular_core.OutputRef<PointerEvent | FocusEvent>;
-    /**
-     * Event handler called before focus moves into the popup. Can be prevented.
-     */
+    /** Event handler called when the escape key is down. Can be prevented. */
+    readonly escapeKeyDown: _angular_core.OutputEmitterRef<KeyboardEvent>;
+    /** Event handler called when a pointerdown event happens outside of the popup. Can be prevented. */
+    readonly pointerDownOutside: _angular_core.OutputEmitterRef<RdxOutsidePressDomEvent>;
+    /** Event handler called when focus moves outside of the popup. Can be prevented. */
+    readonly focusOutside: _angular_core.OutputEmitterRef<FocusEvent>;
+    /** Event handler called when an interaction (pointer / focus) happens outside of the popup. */
+    readonly interactOutside: _angular_core.OutputEmitterRef<RdxOutsidePressDomEvent | FocusEvent>;
+    /** Event handler called before focus moves into the popup. Can be prevented. */
     readonly openAutoFocus: _angular_core.OutputRef<Event>;
-    /**
-     * Event handler called before focus returns after the popup is removed. Can be prevented.
-     */
+    /** Event handler called before focus returns after the popup is removed. Can be prevented. */
     readonly closeAutoFocus: _angular_core.OutputRef<Event>;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxPopoverPopup, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxPopoverPopup, "[rdxPopoverPopup]", never, {}, { "escapeKeyDown": "escapeKeyDown"; "pointerDownOutside": "pointerDownOutside"; "focusOutside": "focusOutside"; "interactOutside": "interactOutside"; "openAutoFocus": "openAutoFocus"; "closeAutoFocus": "closeAutoFocus"; }, never, never, true, [{ directive: typeof i1$1.RdxPopperContent; inputs: {}; outputs: {}; }, { directive: typeof i2.RdxDismissableLayer; inputs: {}; outputs: {}; }, { directive: typeof i3.RdxFocusScope; inputs: {}; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxPopoverPopup, "[rdxPopoverPopup]", never, {}, { "escapeKeyDown": "escapeKeyDown"; "pointerDownOutside": "pointerDownOutside"; "focusOutside": "focusOutside"; "interactOutside": "interactOutside"; "openAutoFocus": "openAutoFocus"; "closeAutoFocus": "closeAutoFocus"; }, never, never, true, [{ directive: typeof i1$1.RdxPopperContent; inputs: {}; outputs: {}; }, { directive: typeof _radix_ng_primitives_core.RdxFloatingNodeRegistration; inputs: {}; outputs: {}; }, { directive: typeof _radix_ng_primitives_floating_focus_manager.RdxFloatingFocusManager; inputs: {}; outputs: {}; }]>;
 }
 
 /**
@@ -414,4 +393,4 @@ declare class RdxPopoverModule {
 }
 
 export { RdxPopoverArrow, RdxPopoverBackdrop, RdxPopoverClose, RdxPopoverDescription, RdxPopoverHandle, RdxPopoverModule, RdxPopoverPopup, RdxPopoverPortal, RdxPopoverPortalMisuseGuard, RdxPopoverPositioner, RdxPopoverRoot, RdxPopoverTitle, RdxPopoverTrigger, RdxPopoverViewport, createRdxPopoverHandle, injectRdxPopoverRootContext, popoverImports, provideRdxPopoverRootContext };
-export type { RdxPopoverModal, RdxPopoverOpenChange, RdxPopoverOpenChangeReason, RdxPopoverRootContext, RdxPopoverTransitionStatus };
+export type { RdxPopoverModal, RdxPopoverOpenChange, RdxPopoverOpenChangeEventDetails, RdxPopoverOpenChangeReason, RdxPopoverRootContext, RdxPopoverTransitionStatus };