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

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

@@ -1,13 +1,16 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, OutputRef, ElementRef } from '@angular/core';
+import { InjectionToken, OutputRef, Signal, ElementRef } from '@angular/core';
 import * as _radix_ng_primitives_core from '@radix-ng/primitives/core';
-import { AcceptableValue, Direction, ItemValueComparator } from '@radix-ng/primitives/core';
+import { AcceptableValue, RdxCancelableChangeEventDetails, RdxFloatingRootContext, Direction, ItemValueComparator } from '@radix-ng/primitives/core';
 import * as _radix_ng_primitives_select from '@radix-ng/primitives/select';
+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 from '@radix-ng/primitives/collection';
 import { RdxCollectionItem } from '@radix-ng/primitives/collection';
+import { RdxOutsidePressDomEvent } from '@radix-ng/primitives/dismissable-layer';
 import * as i1$1 from '@radix-ng/primitives/popper';
-import * as i2 from '@radix-ng/primitives/focus-scope';
-import * as i3 from '@radix-ng/primitives/dismissable-layer';
+import { RdxPopperContentWrapper } from '@radix-ng/primitives/popper';
+import * as _radix_ng_primitives_types_radix_ng_primitives_floating_focus_manager from '@radix-ng/primitives/types/radix-ng-primitives-floating-focus-manager';
 import * as _radix_ng_primitives_types_radix_ng_primitives_core from '@radix-ng/primitives/types/radix-ng-primitives-core';
 import * as _radix_ng_primitives_types_radix_ng_primitives_collection from '@radix-ng/primitives/types/radix-ng-primitives-collection';
 import * as i1$2 from '@radix-ng/primitives/portal';
@@ -32,12 +35,16 @@ declare class RdxSelectBackdrop {
             y: number;
         } | null>;
         contentId: string;
-        dir: _angular_core.InputSignal<_radix_ng_primitives_types_radix_ng_primitives_core.Direction>;
+        dir: _angular_core.Signal<_radix_ng_primitives_types_radix_ng_primitives_core.Direction>;
         value: _angular_core.ModelSignal<_radix_ng_primitives_types_radix_ng_primitives_core.AcceptableValue | _radix_ng_primitives_types_radix_ng_primitives_core.AcceptableValue[] | undefined>;
         multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
         isItemEqualToValue: _angular_core.InputSignal<_radix_ng_primitives_types_radix_ng_primitives_core.ItemValueComparator<_radix_ng_primitives_types_radix_ng_primitives_core.AcceptableValue> | undefined>;
         itemToStringLabel: _angular_core.InputSignal<((value: _radix_ng_primitives_types_radix_ng_primitives_core.AcceptableValue) => string) | undefined>;
         open: _angular_core.ModelSignal<boolean>;
+        openedByTouch: _angular_core.WritableSignal<boolean>;
+        openMethod: _angular_core.Signal<_radix_ng_primitives_types_radix_ng_primitives_floating_focus_manager.RdxInteractionType>;
+        openInteractionType: _angular_core.WritableSignal<_radix_ng_primitives_types_radix_ng_primitives_floating_focus_manager.RdxInteractionType>;
+        closeInteractionType: _angular_core.WritableSignal<_radix_ng_primitives_types_radix_ng_primitives_floating_focus_manager.RdxInteractionType>;
         disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
         modal: _angular_core.InputSignalWithTransform<boolean, unknown>;
         isEmptyModelValue: _angular_core.Signal<boolean>;
@@ -46,10 +53,10 @@ declare class RdxSelectBackdrop {
         optionsSet: _angular_core.WritableSignal<Set<_radix_ng_primitives_select.SelectOption>>;
         onOptionAdd: (option: any) => void;
         onOptionRemove: (option: any) => void;
-        onValueChange: (value: _radix_ng_primitives_types_radix_ng_primitives_core.AcceptableValue) => void;
+        onValueChange: (value: _radix_ng_primitives_types_radix_ng_primitives_core.AcceptableValue, reason?: _radix_ng_primitives_select.RdxSelectValueChangeReason, event?: Event) => boolean;
         onTriggerChange: (node: any) => void;
         onValueElementChange: (node: any) => void;
-        onOpenChange: (value: any) => void;
+        onOpenChange: (value: boolean, reason?: _radix_ng_primitives_select.RdxSelectOpenChangeReason, event?: Event) => boolean;
     };
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxSelectBackdrop, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxSelectBackdrop, "[rdxSelectBackdrop]", ["rdxSelectBackdrop"], {}, {}, never, never, true, never>;
@@ -144,12 +151,16 @@ declare class RdxSelectItemText {
             y: number;
         } | null>;
         contentId: string;
-        dir: _angular_core.InputSignal<_radix_ng_primitives_types_radix_ng_primitives_core.Direction>;
+        dir: _angular_core.Signal<_radix_ng_primitives_types_radix_ng_primitives_core.Direction>;
         value: _angular_core.ModelSignal<_radix_ng_primitives_types_radix_ng_primitives_core.AcceptableValue | _radix_ng_primitives_types_radix_ng_primitives_core.AcceptableValue[] | undefined>;
         multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
         isItemEqualToValue: _angular_core.InputSignal<_radix_ng_primitives_types_radix_ng_primitives_core.ItemValueComparator<_radix_ng_primitives_types_radix_ng_primitives_core.AcceptableValue> | undefined>;
         itemToStringLabel: _angular_core.InputSignal<((value: _radix_ng_primitives_types_radix_ng_primitives_core.AcceptableValue) => string) | undefined>;
         open: _angular_core.ModelSignal<boolean>;
+        openedByTouch: _angular_core.WritableSignal<boolean>;
+        openMethod: _angular_core.Signal<_radix_ng_primitives_types_radix_ng_primitives_floating_focus_manager.RdxInteractionType>;
+        openInteractionType: _angular_core.WritableSignal<_radix_ng_primitives_types_radix_ng_primitives_floating_focus_manager.RdxInteractionType>;
+        closeInteractionType: _angular_core.WritableSignal<_radix_ng_primitives_types_radix_ng_primitives_floating_focus_manager.RdxInteractionType>;
         disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
         modal: _angular_core.InputSignalWithTransform<boolean, unknown>;
         isEmptyModelValue: _angular_core.Signal<boolean>;
@@ -158,10 +169,10 @@ declare class RdxSelectItemText {
         optionsSet: _angular_core.WritableSignal<Set<_radix_ng_primitives_select.SelectOption>>;
         onOptionAdd: (option: any) => void;
         onOptionRemove: (option: any) => void;
-        onValueChange: (value: _radix_ng_primitives_types_radix_ng_primitives_core.AcceptableValue) => void;
+        onValueChange: (value: _radix_ng_primitives_types_radix_ng_primitives_core.AcceptableValue, reason?: _radix_ng_primitives_select.RdxSelectValueChangeReason, event?: Event) => boolean;
         onTriggerChange: (node: any) => void;
         onValueElementChange: (node: any) => void;
-        onOpenChange: (value: any) => void;
+        onOpenChange: (value: boolean, reason?: _radix_ng_primitives_select.RdxSelectOpenChangeReason, event?: Event) => boolean;
     };
     readonly contentContext: {
         content: _angular_core.WritableSignal<HTMLElement | null>;
@@ -212,7 +223,7 @@ declare const context$1: () => {
     isPositioned: _angular_core.WritableSignal<boolean>;
     selectedItem: _angular_core.WritableSignal<HTMLElement | undefined>;
     selectedItemText: _angular_core.WritableSignal<HTMLElement | undefined>;
-    highlightedItem: _angular_core.Signal<RdxCollectionItem<unknown> | null>;
+    highlightedItem: Signal<RdxCollectionItem<unknown> | null>;
     isHighlighted: (item: RdxCollectionItem) => boolean;
     highlightItem: (item: RdxCollectionItem) => void;
     isKeyboardActive: () => boolean;
@@ -229,7 +240,7 @@ declare const injectSelectPopupContext: _radix_ng_primitives_core.InjectContext<
     isPositioned: _angular_core.WritableSignal<boolean>;
     selectedItem: _angular_core.WritableSignal<HTMLElement | undefined>;
     selectedItemText: _angular_core.WritableSignal<HTMLElement | undefined>;
-    highlightedItem: _angular_core.Signal<RdxCollectionItem<unknown> | null>;
+    highlightedItem: Signal<RdxCollectionItem<unknown> | null>;
     isHighlighted: (item: RdxCollectionItem) => boolean;
     highlightItem: (item: RdxCollectionItem) => void;
     isKeyboardActive: () => boolean;
@@ -245,7 +256,7 @@ declare const provideSelectPopupContext: (useFactory: () => {
     isPositioned: _angular_core.WritableSignal<boolean>;
     selectedItem: _angular_core.WritableSignal<HTMLElement | undefined>;
     selectedItemText: _angular_core.WritableSignal<HTMLElement | undefined>;
-    highlightedItem: _angular_core.Signal<RdxCollectionItem<unknown> | null>;
+    highlightedItem: Signal<RdxCollectionItem<unknown> | null>;
     isHighlighted: (item: RdxCollectionItem) => boolean;
     highlightItem: (item: RdxCollectionItem) => void;
     isKeyboardActive: () => boolean;
@@ -257,6 +268,13 @@ declare const provideSelectPopupContext: (useFactory: () => {
 }) => _angular_core.Provider;
 interface RdxPositionerImpl {
     placed: OutputRef<any>;
+    /**
+     * Whether **item-aligned** positioning is currently active (Base UI `alignItemWithTriggerActive`).
+     * `true` only for the item-aligned positioner while open **and not touch-opened** — a touch open
+     * falls back to a plain anchored dropdown. The popper positioner omits this (always `false`). The
+     * scroll-lock policy locks an item-aligned popup even when `modal === false` (ADR 0016 §2 / AC #3).
+     */
+    alignItemWithTriggerActive?: Signal<boolean>;
 }
 declare const RDX_SELECT_POSITIONER_TOKEN: InjectionToken<RdxPositionerImpl>;
 /**
@@ -273,7 +291,8 @@ declare const RDX_SELECT_POSITIONER_TOKEN: InjectionToken<RdxPositionerImpl>;
  * @group Components
  */
 declare class RdxSelectPopup {
-    private readonly dismissableLayer;
+    private readonly floatingContext;
+    private readonly registration;
     private readonly currentElement;
     private readonly collection;
     private readonly injector;
@@ -285,31 +304,35 @@ declare class RdxSelectPopup {
             y: number;
         } | null>;
         contentId: string;
-        dir: _angular_core.InputSignal<_radix_ng_primitives_core.Direction>;
+        dir: Signal<_radix_ng_primitives_core.Direction>;
         value: _angular_core.ModelSignal<AcceptableValue | AcceptableValue[] | undefined>;
         multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
         isItemEqualToValue: _angular_core.InputSignal<_radix_ng_primitives_core.ItemValueComparator<AcceptableValue> | undefined>;
         itemToStringLabel: _angular_core.InputSignal<((value: AcceptableValue) => string) | undefined>;
         open: _angular_core.ModelSignal<boolean>;
+        openedByTouch: _angular_core.WritableSignal<boolean>;
+        openMethod: Signal<_radix_ng_primitives_floating_focus_manager.RdxInteractionType>;
+        openInteractionType: _angular_core.WritableSignal<_radix_ng_primitives_floating_focus_manager.RdxInteractionType>;
+        closeInteractionType: _angular_core.WritableSignal<_radix_ng_primitives_floating_focus_manager.RdxInteractionType>;
         disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
         modal: _angular_core.InputSignalWithTransform<boolean, unknown>;
-        isEmptyModelValue: _angular_core.Signal<boolean>;
-        transitionStatus: _angular_core.Signal<_radix_ng_primitives_core.RdxTransitionStatus>;
+        isEmptyModelValue: Signal<boolean>;
+        transitionStatus: Signal<_radix_ng_primitives_core.RdxTransitionStatus>;
         registerTransitionElement: (element: HTMLElement) => () => void;
         optionsSet: _angular_core.WritableSignal<Set<_radix_ng_primitives_select.SelectOption>>;
         onOptionAdd: (option: any) => void;
         onOptionRemove: (option: any) => void;
-        onValueChange: (value: AcceptableValue) => void;
+        onValueChange: (value: AcceptableValue, reason?: _radix_ng_primitives_select.RdxSelectValueChangeReason, event?: Event) => boolean;
         onTriggerChange: (node: any) => void;
         onValueElementChange: (node: any) => void;
-        onOpenChange: (value: any) => void;
+        onOpenChange: (value: boolean, reason?: _radix_ng_primitives_select.RdxSelectOpenChangeReason, event?: Event) => boolean;
     };
     /**
      * The collected items (DOM order). Exposed so the `item-aligned` positioner — now the popup's
      * **ancestor** — can read them without injecting {@link RdxCollectionProvider} (which the popup
      * provides as a descendant, so an upward `inject` would not find it).
      */
-    readonly items: _angular_core.Signal<readonly RdxCollectionItem<any>[]>;
+    readonly items: Signal<readonly RdxCollectionItem<any>[]>;
     /**
      * Highlight-model navigation over the collected items (DOM order). `loop` is disabled so arrow
      * navigation stops at the first / last item instead of wrapping around — matching native
@@ -326,12 +349,12 @@ declare class RdxSelectPopup {
      * Event handler called when the escape key is down.
      * Can be prevented.
      */
-    readonly escapeKeyDown: OutputRef<KeyboardEvent>;
+    readonly escapeKeyDown: _angular_core.OutputEmitterRef<KeyboardEvent>;
     /**
-     * Event handler called when a `pointerdown` event happens outside of the `DismissableLayer`.
+     * Event handler called when a `pointerdown` event happens outside of the popup.
      * Can be prevented.
      */
-    readonly pointerDownOutside: OutputRef<PointerEvent>;
+    readonly pointerDownOutside: _angular_core.OutputEmitterRef<RdxOutsidePressDomEvent>;
     readonly content: _angular_core.WritableSignal<HTMLElement | null>;
     /**
      * The positioner — now an **ancestor** element — provides {@link RDX_SELECT_POSITIONER_TOKEN}
@@ -347,7 +370,7 @@ declare class RdxSelectPopup {
     isKeyboardActive(): boolean;
     handleKeyDown(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxSelectPopup, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxSelectPopup, "[rdxSelectPopup]", never, {}, { "escapeKeyDown": "escapeKeyDown"; "pointerDownOutside": "pointerDownOutside"; }, never, never, true, [{ directive: typeof i1$1.RdxPopperContent; inputs: {}; outputs: {}; }, { directive: typeof i2.RdxFocusScope; inputs: {}; outputs: {}; }, { directive: typeof i3.RdxDismissableLayer; inputs: {}; outputs: {}; }, { directive: typeof i1.RdxCollectionProvider; inputs: {}; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxSelectPopup, "[rdxSelectPopup]", never, {}, { "escapeKeyDown": "escapeKeyDown"; "pointerDownOutside": "pointerDownOutside"; }, never, never, true, [{ directive: typeof i1$1.RdxPopperContent; inputs: {}; outputs: {}; }, { directive: typeof _radix_ng_primitives_floating_focus_manager.RdxFloatingFocusManager; inputs: { "returnFocus": "finalFocus"; }; outputs: {}; }, { directive: typeof _radix_ng_primitives_core.RdxFloatingNodeRegistration; inputs: {}; outputs: {}; }, { directive: typeof i1.RdxCollectionProvider; inputs: {}; outputs: {}; }]>;
 }
 
 /**
@@ -374,63 +397,22 @@ declare class RdxSelectPortalMisuseGuard {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxSelectPortalMisuseGuard, "[rdxSelectPortal]:not(ng-template)", never, {}, {}, never, never, true, never>;
 }
 
-declare class RdxSelectPositioner implements RdxPositionerImpl {
-    /**
-     * The preferred side of the anchor to render against when open.
-     * Will be reversed when collisions occur and avoidCollisions is enabled.
-     */
-    readonly side: _angular_core.InputSignal<"top" | "right" | "bottom" | "left">;
-    /**
-     * The distance in pixels from the anchor.
-     */
-    readonly sideOffset: _angular_core.InputSignalWithTransform<number, unknown>;
-    /**
-     * The preferred alignment against the anchor. May change when collisions occur.
-     */
-    readonly align: _angular_core.InputSignal<"center" | "end" | "start">;
-    /**
-     * An offset in pixels from the `start` or `end` alignment options.
-     */
-    readonly alignOffset: _angular_core.InputSignalWithTransform<number, unknown>;
-    /**
-     * The padding between the arrow and the edges of the content.
-     * If your content has border-radius, this will prevent it from overflowing the corners.
-     */
-    readonly arrowPadding: _angular_core.InputSignalWithTransform<number, unknown>;
-    /**
-     * When `true`, overrides the `side` and `align` preferences to prevent collisions with boundary edges.
-     */
-    readonly avoidCollisions: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /**
-     * The element used as the collision boundary.
-     * By default this is the viewport, though you can provide additional element(s) to be included in this check.
-     */
-    readonly collisionBoundary: _angular_core.InputSignal<ElementRef<HTMLElement> | ElementRef<HTMLElement>[] | undefined>;
-    /**
-     * The distance in pixels from the boundary edges where collision detection should occur.
-     * Accepts a number (same for all sides), or a partial padding object, for example: `{ top: 20, left: 20 }`.
-     */
-    readonly collisionPadding: _angular_core.InputSignal<number | Partial<Record<"top" | "right" | "bottom" | "left", number>>>;
-    /**
-     * The sticky behavior on the `align` axis.
-     * - `partial` will keep the content in the boundary as long as the trigger is at least partially in the boundary
-     * - `always` will keep the content in the boundary regardless.
-     */
-    readonly sticky: _angular_core.InputSignal<"partial" | "always">;
-    /**
-     * Whether to hide the content when the trigger becomes fully occluded.
-     */
-    readonly hideWhenDetached: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /**
-     * Whether to update the position of the floating element on every animation frame if required.
-     */
-    readonly updatePositionStrategy: _angular_core.InputSignal<"always" | "optimized">;
-    /**
-     * Emits when the element is placed.
-     */
-    readonly placed: _angular_core.OutputRef<void>;
+/**
+ * Positions the select popup against the trigger using the popper engine.
+ *
+ * A "thin" positioner (ADR 0012): it inherits the full popper positioning surface — the inputs
+ * (`side`, `sideOffset`, `align`, …), the `placed` output, and the host bindings — from
+ * {@link RdxPopperContentWrapper}, and declares select's Base UI-aligned defaults via the config
+ * provider. It also satisfies {@link RdxPositionerImpl} (via the inherited `placed`) so the popup can
+ * resolve it through {@link RDX_SELECT_POSITIONER_TOKEN}, the same as the item-aligned positioner.
+ */
+declare class RdxSelectPositioner extends RdxPopperContentWrapper implements RdxPositionerImpl {
+    protected readonly positionerStyle: {
+        boxSizing: string;
+    };
+    constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxSelectPositioner, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxSelectPositioner, "[rdxSelectPositioner]", never, { "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; }; "updatePositionStrategy": { "alias": "updatePositionStrategy"; "required": false; "isSignal": true; }; }, { "placed": "placed"; }, never, never, true, [{ directive: typeof i1$1.RdxPopperContentWrapper; inputs: { "side": "side"; "sideOffset": "sideOffset"; "align": "align"; "alignOffset": "alignOffset"; "arrowPadding": "arrowPadding"; "avoidCollisions": "avoidCollisions"; "collisionBoundary": "collisionBoundary"; "collisionPadding": "collisionPadding"; "sticky": "sticky"; "hideWhenDetached": "hideWhenDetached"; "updatePositionStrategy": "updatePositionStrategy"; }; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxSelectPositioner, "[rdxSelectPositioner]", never, {}, {}, never, never, true, never>;
 }
 
 interface SelectOption {
@@ -438,6 +420,19 @@ interface SelectOption {
     disabled?: boolean;
     textContent: string;
 }
+type RdxSelectOpenMethod = RdxInteractionType;
+type RdxSelectOpenChangeReason = 'trigger-press' | 'item-press' | 'outside-press' | 'escape-key' | 'window-resize' | 'focus-out' | 'list-navigation' | 'cancel-open' | 'none';
+type RdxSelectValueChangeReason = RdxSelectOpenChangeReason;
+type RdxSelectOpenChangeEventDetails = RdxCancelableChangeEventDetails<RdxSelectOpenChangeReason>;
+interface RdxSelectOpenChangeEvent {
+    open: boolean;
+    eventDetails: RdxSelectOpenChangeEventDetails;
+}
+type RdxSelectValueChangeEventDetails = RdxCancelableChangeEventDetails<RdxSelectValueChangeReason>;
+interface RdxSelectValueChangeEvent {
+    value: AcceptableValue | AcceptableValue[];
+    eventDetails: RdxSelectValueChangeEventDetails;
+}
 declare const context: () => {
     triggerElement: _angular_core.WritableSignal<HTMLElement | null>;
     valueElement: _angular_core.WritableSignal<HTMLElement | null>;
@@ -446,24 +441,28 @@ declare const context: () => {
         y: number;
     } | null>;
     contentId: string;
-    dir: _angular_core.InputSignal<Direction>;
+    dir: Signal<Direction>;
     value: _angular_core.ModelSignal<AcceptableValue | AcceptableValue[] | undefined>;
     multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
     isItemEqualToValue: _angular_core.InputSignal<ItemValueComparator<AcceptableValue> | undefined>;
     itemToStringLabel: _angular_core.InputSignal<((value: AcceptableValue) => string) | undefined>;
     open: _angular_core.ModelSignal<boolean>;
+    openedByTouch: _angular_core.WritableSignal<boolean>;
+    openMethod: Signal<RdxInteractionType>;
+    openInteractionType: _angular_core.WritableSignal<RdxInteractionType>;
+    closeInteractionType: _angular_core.WritableSignal<RdxInteractionType>;
     disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     modal: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    isEmptyModelValue: _angular_core.Signal<boolean>;
-    transitionStatus: _angular_core.Signal<_radix_ng_primitives_core.RdxTransitionStatus>;
+    isEmptyModelValue: Signal<boolean>;
+    transitionStatus: Signal<_radix_ng_primitives_core.RdxTransitionStatus>;
     registerTransitionElement: (element: HTMLElement) => () => void;
     optionsSet: _angular_core.WritableSignal<Set<SelectOption>>;
     onOptionAdd: (option: any) => void;
     onOptionRemove: (option: any) => void;
-    onValueChange: (value: AcceptableValue) => void;
+    onValueChange: (value: AcceptableValue, reason?: RdxSelectValueChangeReason, event?: Event) => boolean;
     onTriggerChange: (node: any) => void;
     onValueElementChange: (node: any) => void;
-    onOpenChange: (value: any) => void;
+    onOpenChange: (value: boolean, reason?: RdxSelectOpenChangeReason, event?: Event) => boolean;
 };
 type RdxSelectRootContext = ReturnType<typeof context>;
 declare const injectSelectRootContext: _radix_ng_primitives_core.InjectContext<{
@@ -474,24 +473,28 @@ declare const injectSelectRootContext: _radix_ng_primitives_core.InjectContext<{
         y: number;
     } | null>;
     contentId: string;
-    dir: _angular_core.InputSignal<Direction>;
+    dir: Signal<Direction>;
     value: _angular_core.ModelSignal<AcceptableValue | AcceptableValue[] | undefined>;
     multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
     isItemEqualToValue: _angular_core.InputSignal<ItemValueComparator<AcceptableValue> | undefined>;
     itemToStringLabel: _angular_core.InputSignal<((value: AcceptableValue) => string) | undefined>;
     open: _angular_core.ModelSignal<boolean>;
+    openedByTouch: _angular_core.WritableSignal<boolean>;
+    openMethod: Signal<RdxInteractionType>;
+    openInteractionType: _angular_core.WritableSignal<RdxInteractionType>;
+    closeInteractionType: _angular_core.WritableSignal<RdxInteractionType>;
     disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     modal: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    isEmptyModelValue: _angular_core.Signal<boolean>;
-    transitionStatus: _angular_core.Signal<_radix_ng_primitives_core.RdxTransitionStatus>;
+    isEmptyModelValue: Signal<boolean>;
+    transitionStatus: Signal<_radix_ng_primitives_core.RdxTransitionStatus>;
     registerTransitionElement: (element: HTMLElement) => () => void;
     optionsSet: _angular_core.WritableSignal<Set<SelectOption>>;
     onOptionAdd: (option: any) => void;
     onOptionRemove: (option: any) => void;
-    onValueChange: (value: AcceptableValue) => void;
+    onValueChange: (value: AcceptableValue, reason?: RdxSelectValueChangeReason, event?: Event) => boolean;
     onTriggerChange: (node: any) => void;
     onValueElementChange: (node: any) => void;
-    onOpenChange: (value: any) => void;
+    onOpenChange: (value: boolean, reason?: RdxSelectOpenChangeReason, event?: Event) => boolean;
 }>;
 declare const provideSelectRootContext: (useFactory: () => {
     triggerElement: _angular_core.WritableSignal<HTMLElement | null>;
@@ -501,48 +504,68 @@ declare const provideSelectRootContext: (useFactory: () => {
         y: number;
     } | null>;
     contentId: string;
-    dir: _angular_core.InputSignal<Direction>;
+    dir: Signal<Direction>;
     value: _angular_core.ModelSignal<AcceptableValue | AcceptableValue[] | undefined>;
     multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
     isItemEqualToValue: _angular_core.InputSignal<ItemValueComparator<AcceptableValue> | undefined>;
     itemToStringLabel: _angular_core.InputSignal<((value: AcceptableValue) => string) | undefined>;
     open: _angular_core.ModelSignal<boolean>;
+    openedByTouch: _angular_core.WritableSignal<boolean>;
+    openMethod: Signal<RdxInteractionType>;
+    openInteractionType: _angular_core.WritableSignal<RdxInteractionType>;
+    closeInteractionType: _angular_core.WritableSignal<RdxInteractionType>;
     disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     modal: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    isEmptyModelValue: _angular_core.Signal<boolean>;
-    transitionStatus: _angular_core.Signal<_radix_ng_primitives_core.RdxTransitionStatus>;
+    isEmptyModelValue: Signal<boolean>;
+    transitionStatus: Signal<_radix_ng_primitives_core.RdxTransitionStatus>;
     registerTransitionElement: (element: HTMLElement) => () => void;
     optionsSet: _angular_core.WritableSignal<Set<SelectOption>>;
     onOptionAdd: (option: any) => void;
     onOptionRemove: (option: any) => void;
-    onValueChange: (value: AcceptableValue) => void;
+    onValueChange: (value: AcceptableValue, reason?: RdxSelectValueChangeReason, event?: Event) => boolean;
     onTriggerChange: (node: any) => void;
     onValueElementChange: (node: any) => void;
-    onOpenChange: (value: any) => void;
+    onOpenChange: (value: boolean, reason?: RdxSelectOpenChangeReason, event?: Event) => boolean;
 }) => _angular_core.Provider;
 declare class RdxSelectRoot {
+    readonly contentId: string;
     readonly open: _angular_core.ModelSignal<boolean>;
+    /** Whether the current open was initiated by **touch** (ADR 0016 §3 — gates the anchored scroll lock). */
+    readonly openedByTouch: _angular_core.WritableSignal<boolean>;
+    /** How the select was opened. Base UI names this state `openMethod`. */
+    readonly openInteractionType: _angular_core.WritableSignal<RdxInteractionType>;
+    /** How the select was closed. */
+    readonly closeInteractionType: _angular_core.WritableSignal<RdxInteractionType>;
+    /** Public Base UI-aligned alias for the open interaction type. */
+    readonly openMethod: Signal<RdxSelectOpenMethod>;
+    /** Per-popup floating root context (ADR 0015) — `open` / `triggers` / reference for the dismissal engine. */
+    readonly floatingContext: RdxFloatingRootContext;
     readonly value: _angular_core.ModelSignal<AcceptableValue | AcceptableValue[] | undefined>;
     readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Whether the popup is modal: locks page scroll and makes outside content inert while open. */
     readonly modal: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly dir: _angular_core.InputSignal<Direction>;
+    readonly dirInput: _angular_core.InputSignal<Direction | undefined>;
+    readonly dir: Signal<Direction>;
     /** How item values are compared for equality — a function `(a, b) => boolean` or an object key. */
     readonly isItemEqualToValue: _angular_core.InputSignal<ItemValueComparator<AcceptableValue> | undefined>;
     /** Converts a value to its display label (used by `RdxSelectValue`). */
     readonly itemToStringLabel: _angular_core.InputSignal<((value: AcceptableValue) => string) | undefined>;
+    /** Emits before an open-state change is committed; call `eventDetails.cancel()` to veto it. */
+    readonly onOpenChange: _angular_core.OutputEmitterRef<RdxSelectOpenChangeEvent>;
+    /** Emits before a value change is committed; call `eventDetails.cancel()` to veto it. */
+    readonly onValueChange: _angular_core.OutputEmitterRef<RdxSelectValueChangeEvent>;
     /** Emits after the open/close transition (including any exit animation) finishes. */
     readonly onOpenChangeComplete: _angular_core.OutputEmitterRef<boolean>;
     private readonly transition;
     /** Open/close transition phase, for `data-starting-style` / `data-ending-style`. */
-    readonly transitionStatus: _angular_core.Signal<_radix_ng_primitives_core.RdxTransitionStatus>;
+    readonly transitionStatus: Signal<_radix_ng_primitives_core.RdxTransitionStatus>;
     /** Registers the popup element whose animation determines transition completion. */
     readonly registerTransitionElement: (element: HTMLElement) => () => void;
-    readonly isEmptyModelValue: _angular_core.Signal<boolean>;
+    readonly isEmptyModelValue: Signal<boolean>;
     constructor();
     readonly optionsSet: _angular_core.WritableSignal<Set<SelectOption>>;
-    readonly nativeSelectKey: _angular_core.Signal<string>;
+    readonly nativeSelectKey: Signal<string>;
     readonly triggerElement: _angular_core.WritableSignal<HTMLElement | null>;
     readonly valueElement: _angular_core.WritableSignal<HTMLElement | null>;
     readonly triggerPointerDownPosRef: _angular_core.WritableSignal<{
@@ -550,9 +573,10 @@ declare class RdxSelectRoot {
         y: number;
     } | null>;
     getOption(value: SelectOption['value']): SelectOption | undefined;
-    handleValueChange(value: AcceptableValue): void;
+    setValue(value: AcceptableValue, reason?: RdxSelectValueChangeReason, event?: Event): boolean;
+    setOpen(open: boolean, reason?: RdxSelectOpenChangeReason, event?: Event): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxSelectRoot, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxSelectRoot, "[rdxSelectRoot]", ["rdxSelectRoot"], { "open": { "alias": "open"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "modal": { "alias": "modal"; "required": false; "isSignal": true; }; "dir": { "alias": "dir"; "required": false; "isSignal": true; }; "isItemEqualToValue": { "alias": "isItemEqualToValue"; "required": false; "isSignal": true; }; "itemToStringLabel": { "alias": "itemToStringLabel"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "value": "valueChange"; "onOpenChangeComplete": "onOpenChangeComplete"; }, never, never, true, [{ directive: typeof i1$1.RdxPopper; inputs: {}; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxSelectRoot, "[rdxSelectRoot]", ["rdxSelectRoot"], { "open": { "alias": "open"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "modal": { "alias": "modal"; "required": false; "isSignal": true; }; "dirInput": { "alias": "dir"; "required": false; "isSignal": true; }; "isItemEqualToValue": { "alias": "isItemEqualToValue"; "required": false; "isSignal": true; }; "itemToStringLabel": { "alias": "itemToStringLabel"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "value": "valueChange"; "onOpenChange": "onOpenChange"; "onValueChange": "onValueChange"; "onOpenChangeComplete": "onOpenChangeComplete"; }, never, never, true, [{ directive: typeof i1$1.RdxPopper; inputs: {}; outputs: {}; }]>;
 }
 
 /**
@@ -574,12 +598,16 @@ declare class RdxSelectTrigger {
             y: number;
         } | null>;
         contentId: string;
-        dir: _angular_core.InputSignal<_radix_ng_primitives_core.Direction>;
+        dir: _angular_core.Signal<_radix_ng_primitives_core.Direction>;
         value: _angular_core.ModelSignal<_radix_ng_primitives_core.AcceptableValue | _radix_ng_primitives_core.AcceptableValue[] | undefined>;
         multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
         isItemEqualToValue: _angular_core.InputSignal<_radix_ng_primitives_core.ItemValueComparator<_radix_ng_primitives_core.AcceptableValue> | undefined>;
         itemToStringLabel: _angular_core.InputSignal<((value: _radix_ng_primitives_core.AcceptableValue) => string) | undefined>;
         open: _angular_core.ModelSignal<boolean>;
+        openedByTouch: _angular_core.WritableSignal<boolean>;
+        openMethod: _angular_core.Signal<_radix_ng_primitives_floating_focus_manager.RdxInteractionType>;
+        openInteractionType: _angular_core.WritableSignal<_radix_ng_primitives_floating_focus_manager.RdxInteractionType>;
+        closeInteractionType: _angular_core.WritableSignal<_radix_ng_primitives_floating_focus_manager.RdxInteractionType>;
         disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
         modal: _angular_core.InputSignalWithTransform<boolean, unknown>;
         isEmptyModelValue: _angular_core.Signal<boolean>;
@@ -588,10 +616,10 @@ declare class RdxSelectTrigger {
         optionsSet: _angular_core.WritableSignal<Set<_radix_ng_primitives_select.SelectOption>>;
         onOptionAdd: (option: any) => void;
         onOptionRemove: (option: any) => void;
-        onValueChange: (value: _radix_ng_primitives_core.AcceptableValue) => void;
+        onValueChange: (value: _radix_ng_primitives_core.AcceptableValue, reason?: _radix_ng_primitives_select.RdxSelectValueChangeReason, event?: Event) => boolean;
         onTriggerChange: (node: any) => void;
         onValueElementChange: (node: any) => void;
-        onOpenChange: (value: any) => void;
+        onOpenChange: (value: boolean, reason?: _radix_ng_primitives_select.RdxSelectOpenChangeReason, event?: Event) => boolean;
     };
     readonly elementRef: ElementRef<HTMLElement>;
     private readonly fieldRootContext;
@@ -599,13 +627,14 @@ declare class RdxSelectTrigger {
     readonly id: _angular_core.InputSignal<string>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly isDisabled: _angular_core.Signal<boolean>;
+    protected readonly triggerInteraction: _radix_ng_primitives_floating_focus_manager.RdxTriggerInteraction;
     protected readonly invalidState: _angular_core.Signal<boolean>;
     protected readonly requiredState: _angular_core.Signal<boolean>;
     protected readonly filledState: _angular_core.Signal<boolean>;
     protected readonly focusedState: _angular_core.Signal<boolean>;
     protected readonly describedBy: _angular_core.Signal<string | undefined>;
     constructor();
-    handleOpen(): void;
+    handleOpen(reason: 'trigger-press' | 'list-navigation', event: Event): boolean;
     handlePointerOpen(event: Event): void;
     onClickHandler(event: Event): void;
     onPointerDown(event: Event): void;
@@ -627,12 +656,16 @@ declare class RdxSelectValue {
             y: number;
         } | null>;
         contentId: string;
-        dir: _angular_core.InputSignal<_radix_ng_primitives_core.Direction>;
+        dir: _angular_core.Signal<_radix_ng_primitives_core.Direction>;
         value: _angular_core.ModelSignal<AcceptableValue | AcceptableValue[] | undefined>;
         multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
         isItemEqualToValue: _angular_core.InputSignal<_radix_ng_primitives_core.ItemValueComparator<AcceptableValue> | undefined>;
         itemToStringLabel: _angular_core.InputSignal<((value: AcceptableValue) => string) | undefined>;
         open: _angular_core.ModelSignal<boolean>;
+        openedByTouch: _angular_core.WritableSignal<boolean>;
+        openMethod: _angular_core.Signal<_radix_ng_primitives_types_radix_ng_primitives_floating_focus_manager.RdxInteractionType>;
+        openInteractionType: _angular_core.WritableSignal<_radix_ng_primitives_types_radix_ng_primitives_floating_focus_manager.RdxInteractionType>;
+        closeInteractionType: _angular_core.WritableSignal<_radix_ng_primitives_types_radix_ng_primitives_floating_focus_manager.RdxInteractionType>;
         disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
         modal: _angular_core.InputSignalWithTransform<boolean, unknown>;
         isEmptyModelValue: _angular_core.Signal<boolean>;
@@ -641,10 +674,10 @@ declare class RdxSelectValue {
         optionsSet: _angular_core.WritableSignal<Set<_radix_ng_primitives_select.SelectOption>>;
         onOptionAdd: (option: any) => void;
         onOptionRemove: (option: any) => void;
-        onValueChange: (value: AcceptableValue) => void;
+        onValueChange: (value: AcceptableValue, reason?: _radix_ng_primitives_select.RdxSelectValueChangeReason, event?: Event) => boolean;
         onTriggerChange: (node: any) => void;
         onValueElementChange: (node: any) => void;
-        onOpenChange: (value: any) => void;
+        onOpenChange: (value: boolean, reason?: _radix_ng_primitives_select.RdxSelectOpenChangeReason, event?: Event) => boolean;
     };
     readonly elementRef: ElementRef<HTMLElement>;
     readonly placeholder: _angular_core.InputSignal<string | undefined>;
@@ -666,4 +699,4 @@ declare function focusFirst(candidates: HTMLElement[]): void;
 declare const _importsSelect: (typeof RdxSelectGroupLabel)[];
 
 export { CONTENT_MARGIN, OPEN_KEYS, RDX_SELECT_POSITIONER_TOKEN, RdxSelectBackdrop, RdxSelectGroup, RdxSelectGroupLabel, RdxSelectIcon, RdxSelectItem, RdxSelectItemIndicator, RdxSelectItemText, RdxSelectList, RdxSelectPopup, RdxSelectPortal, RdxSelectPortalMisuseGuard, RdxSelectPositioner, RdxSelectRoot, RdxSelectSeparator, RdxSelectTrigger, RdxSelectValue, SELECTION_KEYS, _importsSelect, compare, focusFirst, injectSelectItemContext, injectSelectPopupContext, injectSelectRootContext, provideSelectItemContext, provideSelectPopupContext, provideSelectRootContext, shouldShowPlaceholder, valueComparator };
-export type { RdxPositionerImpl, RdxSelectItemContext, RdxSelectPopupContext, RdxSelectRootContext, SelectEvent, SelectOption };
+export type { RdxPositionerImpl, RdxSelectItemContext, RdxSelectOpenChangeEvent, RdxSelectOpenChangeEventDetails, RdxSelectOpenChangeReason, RdxSelectOpenMethod, RdxSelectPopupContext, RdxSelectRootContext, RdxSelectValueChangeEvent, RdxSelectValueChangeEventDetails, RdxSelectValueChangeReason, SelectEvent, SelectOption };