@radix-ng/primitives 1.0.5 → 1.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@radix-ng/primitives",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Headless, signals-first UI primitives for Angular.",
   "license": "MIT",
   "publishConfig": {
@@ -19,7 +19,7 @@
     "headless"
   ],
   "peerDependencies": {
-    "@angular/core": "^21.0.0",
+    "@angular/core": "^21.0.0 || ^22.0.0",
     "@floating-ui/dom": "^1.7.6",
     "@internationalized/date": "^3.12.2",
     "@internationalized/number": "^3.6.7"

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

@@ -3,7 +3,7 @@ import * as _radix_ng_primitives_combobox from '@radix-ng/primitives/combobox';
 import { RdxComboboxOpenChange, ComboboxItemHighlightedDetails, ComboboxInputLayout, ComboboxItemRef, RdxComboboxOpenChangeReason, ComboboxHighlightReason } from '@radix-ng/primitives/combobox';
 export { ComboboxHighlightReason as AutocompleteHighlightReason, ComboboxItemHighlightedDetails as AutocompleteItemHighlightedDetails } from '@radix-ng/primitives/combobox';
 import * as _radix_ng_primitives_core from '@radix-ng/primitives/core';
-import { AcceptableValue, RdxFloatingRootContext, Direction, BooleanInput, ItemValueComparator } from '@radix-ng/primitives/core';
+import { AcceptableValue, RdxCancelableChangeEventDetails, RdxFloatingRootContext, Direction, BooleanInput, ItemValueComparator } from '@radix-ng/primitives/core';
 import { ControlValueAccessor } from '@angular/forms';
 import * as i1 from '@radix-ng/primitives/popper';
 import { RdxPopperContentWrapper } from '@radix-ng/primitives/popper';
@@ -45,6 +45,8 @@ interface AutocompleteValueChangeDetails {
     value: string;
     /** What caused the change (e.g. skip `'item-press'` to avoid overwriting an external value). */
     reason: AutocompleteChangeReason;
+    /** Cancelable details — call `eventDetails.cancel()` to veto the change. */
+    eventDetails: RdxCancelableChangeEventDetails<AutocompleteChangeReason>;
 }
 
 /**

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

@@ -3,7 +3,7 @@ import { Signal, Injector } from '@angular/core';
 import * as i1 from '@radix-ng/primitives/popper';
 import { RdxPopperContentWrapper } from '@radix-ng/primitives/popper';
 import * as _radix_ng_primitives_core from '@radix-ng/primitives/core';
-import { AcceptableValue, RdxFloatingRootContext, Direction, BooleanInput, ItemValueComparator, RdxCancelableChangeEventDetails } from '@radix-ng/primitives/core';
+import { AcceptableValue, RdxCancelableChangeEventDetails, RdxFloatingRootContext, Direction, BooleanInput, ItemValueComparator } from '@radix-ng/primitives/core';
 import { ControlValueAccessor } from '@angular/forms';
 import * as _radix_ng_primitives_combobox from '@radix-ng/primitives/combobox';
 import * as i1$1 from '@radix-ng/primitives/dismissable-layer';
@@ -196,6 +196,20 @@ interface RdxComboboxOpenChange {
     trigger: HTMLElement | undefined;
     eventDetails: RdxComboboxOpenChangeEventDetails;
 }
+/** Why the selected value changed (Base UI value-change `reason`). */
+type RdxComboboxValueChangeReason = 'item-press' | 'clear-press' | 'chip-remove-press' | 'input-clear' | 'none';
+type RdxComboboxValueChangeEventDetails = RdxCancelableChangeEventDetails<RdxComboboxValueChangeReason>;
+/** Payload of {@link RdxComboboxRoot.onValueChange} — cancelable via `eventDetails.cancel()`. */
+interface RdxComboboxValueChange {
+    value: ComboboxValue | null;
+    reason: RdxComboboxValueChangeReason;
+    eventDetails: RdxComboboxValueChangeEventDetails;
+}
+/** Payload of {@link RdxComboboxRoot.onInputValueChange} — cancelable via `eventDetails.cancel()`. */
+interface RdxComboboxInputValueChange {
+    value: string;
+    eventDetails: RdxComboboxValueChangeEventDetails;
+}
 
 declare const context: () => {
     listId: string;
@@ -516,10 +530,10 @@ declare class RdxComboboxRoot implements ControlValueAccessor {
     readonly isItemEqualToValue: _angular_core.InputSignal<ItemValueComparator<AcceptableValue> | undefined>;
     /** Converts a value to its display label. Defaults to the matching item's text. */
     readonly itemToStringLabel: _angular_core.InputSignal<((value: AcceptableValue) => string) | undefined>;
-    /** Emits when the selection changes. */
-    readonly onValueChange: _angular_core.OutputEmitterRef<ComboboxValue>;
-    /** Emits when the input text changes. */
-    readonly onInputValueChange: _angular_core.OutputEmitterRef<string>;
+    /** Emits before the selection changes; call `eventDetails.cancel()` to veto it. */
+    readonly onValueChange: _angular_core.OutputEmitterRef<RdxComboboxValueChange>;
+    /** Emits before the input text changes; call `eventDetails.cancel()` to veto it. */
+    readonly onInputValueChange: _angular_core.OutputEmitterRef<RdxComboboxInputValueChange>;
     /** Emits when the popup opens or closes. */
     readonly onOpenChange: _angular_core.OutputEmitterRef<RdxComboboxOpenChange>;
     /**
@@ -576,9 +590,12 @@ declare class RdxComboboxRoot implements ControlValueAccessor {
     isSelected(value: AcceptableValue): boolean;
     setOpen(open: boolean, reason?: RdxComboboxOpenChangeReason, event?: Event): boolean;
     closePopup(revert?: boolean, reason?: RdxComboboxOpenChangeReason, event?: Event): void;
-    /** Updates the input text from user typing (marks the query as a fresh user query). */
-    setInputValue(value: string): void;
-    /** Sets the input text programmatically (a selection label / revert) — not a user query. */
+    /** Updates the input text from user typing (marks the query as a fresh user query). Cancelable. */
+    setInputValue(value: string, event?: Event): void;
+    /**
+     * Sets the input text programmatically (a selection label / revert) — not a user query. Emits
+     * `onInputValueChange` for observability but is not vetoable (it is a derived sync, not a user edit).
+     */
     private setLabel;
     /** Resets the input text to the current selection's label (single mode) or empty. */
     private revertInputValue;
@@ -938,6 +955,8 @@ declare class RdxComboboxTrigger {
         markAsTouched: () => void;
     };
     private readonly element;
+    /** Whether the trigger is currently pressed (pointer down), for Base UI's `data-pressed`. */
+    protected readonly pressed: _angular_core.WritableSignal<boolean>;
     constructor();
     onPointerDown(event: PointerEvent): void;
     onClick(event: MouseEvent): void;
@@ -1696,4 +1715,4 @@ declare class RdxComboboxModule {
 }
 
 export { RdxComboboxAnchor, RdxComboboxArrow, RdxComboboxBackdrop, RdxComboboxChip, RdxComboboxChipRemove, RdxComboboxChips, RdxComboboxClear, RdxComboboxEmpty, RdxComboboxGroup, RdxComboboxGroupLabel, RdxComboboxIcon, RdxComboboxInput, RdxComboboxInputGroup, RdxComboboxItem, RdxComboboxItemIndicator, RdxComboboxLabel, RdxComboboxList, RdxComboboxModule, RdxComboboxPopup, RdxComboboxPortal, RdxComboboxPortalMisuseGuard, RdxComboboxPositioner, RdxComboboxRoot, RdxComboboxRow, RdxComboboxSeparator, RdxComboboxStatus, RdxComboboxTrigger, RdxComboboxValue, _importsCombobox, injectComboboxChipContext, injectComboboxGroupContext, injectComboboxItemContext, injectComboboxRootContext, provideComboboxChipContext, provideComboboxGroupContext, provideComboboxItemContext, provideComboboxRootContext, useComboboxEngine };
-export type { ComboboxFilter, ComboboxHighlightReason, ComboboxInputLayout, ComboboxItemHighlightedDetails, ComboboxItemRef, ComboboxValue, RdxComboboxChipContext, RdxComboboxGroupContext, RdxComboboxItemContext, RdxComboboxOpenChange, RdxComboboxOpenChangeEventDetails, RdxComboboxOpenChangeReason, RdxComboboxRootContext };
+export type { ComboboxFilter, ComboboxHighlightReason, ComboboxInputLayout, ComboboxItemHighlightedDetails, ComboboxItemRef, ComboboxValue, RdxComboboxChipContext, RdxComboboxGroupContext, RdxComboboxInputValueChange, RdxComboboxItemContext, RdxComboboxOpenChange, RdxComboboxOpenChangeEventDetails, RdxComboboxOpenChangeReason, RdxComboboxRootContext, RdxComboboxValueChange, RdxComboboxValueChangeEventDetails, RdxComboboxValueChangeReason };

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

@@ -57,6 +57,8 @@ declare class RdxContextMenuTrigger {
     readonly disabled: i0.InputSignalWithTransform<boolean, BooleanInput>;
     /** How long (ms) a touch must be held before the menu opens. */
     readonly longPressDelay: i0.InputSignalWithTransform<number, NumberInput>;
+    /** Whether the trigger is mid-press (Base UI `data-pressed`). */
+    protected readonly pressed: i0.WritableSignal<boolean>;
     private longPressTimer;
     private allowMouseUpTimer;
     private longPressOrigin;

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

@@ -112,6 +112,8 @@ interface RdxDialogRootContext {
     /** Whether this dialog is nested in another; constant, fixed at construction. */
     nested: boolean;
     nestedDialogOpen: Signal<boolean>;
+    /** Number of currently-open dialogs nested directly inside this one (Base UI `--nested-dialogs`). */
+    nestedOpenCount: Signal<number>;
     setTitleId: (id: string | undefined) => void;
     setDescriptionId: (id: string | undefined) => void;
     registerTransitionElement: (element: HTMLElement) => () => void;
@@ -160,13 +162,14 @@ declare class RdxDialogRoot {
      */
     readonly modal: _angular_core.InputSignalWithTransform<RdxDialogModal, BooleanInput>;
     /**
-     * Determines whether the dialog should close on outside clicks.
+     * Determines whether the dialog should close on outside clicks. For a non-modal dialog this also
+     * prevents the dialog from closing when focus moves outside of it.
      */
     readonly disablePointerDismissal: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
     /**
      * Associates this root with detached trigger elements rendered outside of it.
      */
-    readonly handle: _angular_core.InputSignal<RdxDialogHandle<any> | undefined>;
+    readonly handle: _angular_core.InputSignal<RdxDialogHandle<unknown> | undefined>;
     /**
      * Event handler called when the dialog is opened or closed.
      */
@@ -227,7 +230,7 @@ declare class RdxDialogTrigger {
     /**
      * Associates this trigger with a detached dialog root.
      */
-    readonly handle: _angular_core.InputSignal<RdxDialogHandle<any> | undefined>;
+    readonly handle: _angular_core.InputSignal<RdxDialogHandle<unknown> | undefined>;
     /**
      * Data associated with this trigger while it is active.
      */

package/types/radix-ng-primitives-floating-focus-manager.d.ts

@@ -200,6 +200,17 @@ declare class RdxFloatingFocusManager {
      * The marker keep-set is intentionally narrow: the popup/focus host only. Own sibling roots such as a
      * user backdrop are DOM-footprint bookkeeping, not marker keep-set members.
      */
+    /**
+     * The kept ("avoid") subtree for the `markOthers` background-isolation passes — the floating element
+     * and any primitive-declared inside elements (e.g. a combobox input that must stay interactive).
+     *
+     * It deliberately excludes `previous/nextFocusableElement`: those exist for focus-guard tabbability and
+     * return-focus (Base UI's `markOthers(insideElements)` aria-hidden pass keeps them, but its **marker**
+     * pass — `markOthers([floating, ...portalNodes])` — does not). A modal popover declares its trigger as
+     * `previousFocusableElement`; sparing it here used to leak the trigger's whole ancestor chain (the app
+     * root) out of the isolation, so a modal popover failed to inert/mark the dimmed background. Keeping the
+     * isolation tied to the floating subtree restores full modality.
+     */
     private avoidElements;
     private isFloatingOpen;
     /** Whether `relatedTarget` is inside the popup, its trigger(s), or an ancestor / descendant popup. */

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

@@ -1,7 +1,7 @@
 import * as _angular_core from '@angular/core';
-import { Signal, WritableSignal } from '@angular/core';
+import { InjectionToken, Signal, WritableSignal } from '@angular/core';
 import * as _radix_ng_primitives_core from '@radix-ng/primitives/core';
-import { RdxFloatingRootContext, BooleanInput, Direction, RdxCancelableChangeEventDetails, NumberInput } from '@radix-ng/primitives/core';
+import { RdxFloatingRootContext, BooleanInput, Direction, RdxCancelableChangeEventDetails, NumberInput, DataOrientation } 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 from '@radix-ng/primitives/popper';
@@ -12,6 +12,12 @@ import * as i1$2 from '@radix-ng/primitives/portal';
 import { RdxOutsidePressDomEvent } from '@radix-ng/primitives/dismissable-layer';
 
 type RdxMenuTransitionStatus = 'starting' | 'ending' | undefined;
+/**
+ * Why an open/close happened instantly (no transition). Mirrors Base UI's menu `data-instant`:
+ * `'click'` (opened by click/keyboard), `'dismiss'` (closed by Escape / outside-press / focus-out),
+ * `'group'`, or `'trigger-change'` (menubar switching between sibling menus).
+ */
+type RdxMenuInstantType = 'click' | 'dismiss' | 'group' | 'trigger-change';
 /**
  * How focus moves into the popup when it opens.
  * - `'first'` / `'last'` — focus and highlight the first / last item (keyboard opening).
@@ -63,6 +69,8 @@ interface RdxMenuRootContext {
     parentType: Signal<RdxMenuParentType>;
     /** The reason for the most recent open-change (Base UI open-change `reason`). */
     lastOpenChangeReason: Signal<RdxMenuOpenChangeReason>;
+    /** Why the open/close was instant (Base UI `data-instant`), or `undefined` when it animates. */
+    instantType: Signal<RdxMenuInstantType | undefined>;
     /** Whether a trigger-originated press may activate an item on the following mouseup. */
     allowMouseUpTrigger: Signal<boolean>;
     /** Whether the current open was initiated by touch (ADR 0016 §3 — gates the anchored scroll lock). */
@@ -133,6 +141,12 @@ type RdxMenuTriggerInteraction = {
 type RdxMenuTriggerInteractionHandler = (interaction: RdxMenuTriggerInteraction) => boolean;
 declare const injectRdxMenuRootContext: _radix_ng_primitives_core.InjectContext<RdxMenuRootContext>;
 declare const provideRdxMenuRootContext: (useFactory: () => RdxMenuRootContext) => _angular_core.Provider;
+/**
+ * Ambient modality for a menu, provided by a coordinator (e.g. `Menubar`) so its child menus inherit
+ * the coordinator's `modal` setting instead of each defaulting independently. A top-level menu prefers
+ * this over its own `modal` input when present; submenus stay non-modal regardless.
+ */
+declare const RDX_MENU_AMBIENT_MODAL: InjectionToken<Signal<boolean>>;
 /**
  * Groups all parts of a menu.
  */
@@ -140,6 +154,8 @@ declare class RdxMenuRoot {
     private readonly popper;
     readonly parentRoot: RdxMenuRoot | null;
     private readonly providedDirection;
+    /** Ambient modality from an enclosing coordinator (e.g. Menubar). Overrides own `modal` for top-level menus. */
+    private readonly ambientModal;
     /**
      * The shared per-popup floating context (ADR 0015 §1) — `open` mirrors this menu's open state, the
      * trigger registry is bridged from {@link registerTrigger}, and the reference / floating elements are
@@ -208,6 +224,8 @@ declare class RdxMenuRoot {
     readonly effectiveModal: Signal<boolean>;
     readonly state: Signal<"open" | "closed">;
     readonly present: Signal<boolean>;
+    /** Base UI `data-instant`: the open/close reason classified into the instant-suppression bucket. */
+    readonly instantType: Signal<RdxMenuInstantType | undefined>;
     constructor();
     show(autoFocus?: RdxMenuAutoFocusInput, reason?: RdxMenuOpenChangeReason, event?: Event): void;
     close(reason?: RdxMenuOpenChangeReason, event?: Event): void;
@@ -262,6 +280,8 @@ declare class RdxMenuTrigger {
     /** Delay before hover leave closes the menu, in milliseconds. */
     readonly closeDelay: _angular_core.InputSignalWithTransform<number | undefined, NumberInput>;
     protected readonly nativeButtonState: _angular_core.Signal<boolean>;
+    /** Whether the trigger is currently pressed (pointer down), for Base UI's `data-pressed`. */
+    protected readonly pressed: _angular_core.WritableSignal<boolean>;
     protected readonly isDisabled: _angular_core.Signal<boolean>;
     protected readonly triggerInteraction: _radix_ng_primitives_floating_focus_manager.RdxTriggerInteraction;
     constructor();
@@ -584,8 +604,10 @@ declare class RdxMenuGroupLabel {
  * A visual separator between groups of menu items.
  */
 declare class RdxMenuSeparator {
+    /** The orientation of the separator. Matches Base UI's `Separator.orientation`. */
+    readonly orientation: _angular_core.InputSignal<DataOrientation>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxMenuSeparator, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxMenuSeparator, "[rdxMenuSeparator]", ["rdxMenuSeparator"], {}, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxMenuSeparator, "[rdxMenuSeparator]", ["rdxMenuSeparator"], { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 type CheckedState = boolean | 'indeterminate';
@@ -595,6 +617,11 @@ declare function getCheckedState(checked: CheckedState): 'checked' | 'unchecked'
 interface RdxMenuCheckboxItemContext {
     checked: Signal<CheckedState>;
 }
+/** Payload of {@link RdxMenuCheckboxItem.onCheckedChange} — cancelable via `eventDetails.cancel()`. */
+interface RdxMenuCheckboxChangeEvent {
+    checked: CheckedState;
+    eventDetails: RdxCancelableChangeEventDetails<'none'>;
+}
 declare const injectRdxMenuCheckboxItemContext: _radix_ng_primitives_core.InjectContext<RdxMenuCheckboxItemContext>;
 declare const provideRdxMenuCheckboxItemContext: (useFactory: () => RdxMenuCheckboxItemContext) => _angular_core.Provider;
 /**
@@ -613,12 +640,11 @@ declare class RdxMenuCheckboxItem {
     readonly label: _angular_core.InputSignal<string | undefined>;
     /** The checked state of the item. */
     readonly checked: _angular_core.ModelSignal<CheckedState>;
-    /** Emits when the checked state changes. */
-    readonly onCheckedChange: _angular_core.OutputEmitterRef<CheckedState>;
+    /** Emits before the checked state changes; call `eventDetails.cancel()` to veto it. */
+    readonly onCheckedChange: _angular_core.OutputEmitterRef<RdxMenuCheckboxChangeEvent>;
     protected readonly highlighted: Signal<boolean>;
     protected readonly effectiveDisabled: Signal<boolean>;
     protected readonly isIndeterminate: typeof isIndeterminate;
-    protected readonly getCheckedState: typeof getCheckedState;
     constructor();
     onFocus(): void;
     onBlur(): void;
@@ -627,6 +653,7 @@ declare class RdxMenuCheckboxItem {
     onItemClick(): void;
     onMouseUp(event: MouseEvent): void;
     protected onActivate(event: Event): void;
+    /** Emits the cancelable change, applies it unless vetoed, and reports whether it was applied. */
     private toggleChecked;
     private setActiveIndex;
     private clearActiveIndex;
@@ -642,7 +669,8 @@ declare class RdxMenuCheckboxItemIndicator {
     private readonly itemContext;
     /** Keep the indicator in the DOM when unchecked so CSS exit animations can play. */
     readonly keepMounted: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
-    protected readonly dataState: _angular_core.Signal<"indeterminate" | "checked" | "unchecked">;
+    protected readonly checked: _angular_core.Signal<_radix_ng_primitives_menu.CheckedState>;
+    protected readonly isIndeterminate: typeof isIndeterminate;
     protected readonly isVisible: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxMenuCheckboxItemIndicator, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxMenuCheckboxItemIndicator, "[rdxMenuCheckboxItemIndicator]", ["rdxMenuCheckboxItemIndicator"], { "keepMounted": { "alias": "keepMounted"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -651,7 +679,12 @@ declare class RdxMenuCheckboxItemIndicator {
 interface RdxMenuRadioGroupContext<T = unknown> {
     value: Signal<T | undefined>;
     disabled: Signal<boolean>;
-    selectValue: (value: T) => void;
+    selectValue: (value: T, event?: Event) => void;
+}
+/** Payload of {@link RdxMenuRadioGroup.onValueChange} — cancelable via `eventDetails.cancel()`. */
+interface RdxMenuRadioGroupValueChangeEvent<T = unknown> {
+    value: T;
+    eventDetails: RdxCancelableChangeEventDetails<'none'>;
 }
 declare const injectRdxMenuRadioGroupContext: _radix_ng_primitives_core.InjectContext<RdxMenuRadioGroupContext<unknown>>;
 declare const provideRdxMenuRadioGroupContext: (useFactory: () => RdxMenuRadioGroupContext<unknown>) => _angular_core.Provider;
@@ -669,12 +702,12 @@ declare class RdxMenuRadioGroup<T = unknown> {
     /** Whether all radio items in the group are disabled. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
     /**
-     * Emits when the selected value changes.
+     * Emits before the selected value changes; call `eventDetails.cancel()` to veto it.
      */
-    readonly onValueChange: _angular_core.OutputEmitterRef<T>;
+    readonly onValueChange: _angular_core.OutputEmitterRef<RdxMenuRadioGroupValueChangeEvent<T>>;
     readonly labelId: _angular_core.WritableSignal<string | undefined>;
     constructor();
-    selectValue(newValue: T): void;
+    selectValue(newValue: T, event?: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxMenuRadioGroup<any>, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxMenuRadioGroup<any>, "[rdxMenuRadioGroup]", ["rdxMenuRadioGroup"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "defaultValue": { "alias": "defaultValue"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "onValueChange": "onValueChange"; }, never, never, true, never>;
 }
@@ -706,7 +739,6 @@ declare class RdxMenuRadioItem<T = unknown> {
     readonly checked: Signal<boolean>;
     protected readonly highlighted: Signal<boolean>;
     protected readonly effectiveDisabled: Signal<boolean>;
-    protected readonly getCheckedState: typeof getCheckedState;
     constructor();
     onFocus(): void;
     onBlur(): void;
@@ -730,7 +762,7 @@ declare class RdxMenuRadioItemIndicator {
     private readonly itemContext;
     /** Keep the indicator in the DOM when unselected so CSS exit animations can play. */
     readonly keepMounted: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
-    protected readonly dataState: _angular_core.Signal<"indeterminate" | "checked" | "unchecked">;
+    protected readonly checked: _angular_core.Signal<boolean>;
     protected readonly isVisible: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxMenuRadioItemIndicator, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxMenuRadioItemIndicator, "[rdxMenuRadioItemIndicator]", ["rdxMenuRadioItemIndicator"], { "keepMounted": { "alias": "keepMounted"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -748,5 +780,5 @@ declare class RdxMenuModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<RdxMenuModule>;
 }
 
-export { RdxMenuArrow, RdxMenuBackdrop, RdxMenuCheckboxItem, RdxMenuCheckboxItemIndicator, RdxMenuGroup, RdxMenuGroupLabel, RdxMenuItem, RdxMenuLinkItem, RdxMenuModule, RdxMenuPopup, RdxMenuPortal, RdxMenuPortalMisuseGuard, RdxMenuPositioner, RdxMenuRadioGroup, RdxMenuRadioItem, RdxMenuRadioItemIndicator, RdxMenuRoot, RdxMenuSeparator, RdxMenuSubTrigger, RdxMenuTrigger, RdxMenuViewport, getCheckedState, injectRdxMenuCheckboxItemContext, injectRdxMenuGroupContext, injectRdxMenuRadioGroupContext, injectRdxMenuRadioItemContext, injectRdxMenuRootContext, isIndeterminate, provideRdxMenuCheckboxItemContext, provideRdxMenuGroupContext, provideRdxMenuRadioGroupContext, provideRdxMenuRadioItemContext, provideRdxMenuRootContext };
-export type { CheckedState, RdxMenuAutoFocus, RdxMenuAutoFocusInput, RdxMenuCheckboxItemContext, RdxMenuGroupContext, RdxMenuOpenChange, RdxMenuOpenChangeEventDetails, RdxMenuOpenChangeReason, RdxMenuOrientation, RdxMenuParentType, RdxMenuRadioGroupContext, RdxMenuRadioItemContext, RdxMenuRootContext, RdxMenuTransitionStatus, RdxMenuTriggerInteraction, RdxMenuTriggerInteractionHandler };
+export { RDX_MENU_AMBIENT_MODAL, RdxMenuArrow, RdxMenuBackdrop, RdxMenuCheckboxItem, RdxMenuCheckboxItemIndicator, RdxMenuGroup, RdxMenuGroupLabel, RdxMenuItem, RdxMenuLinkItem, RdxMenuModule, RdxMenuPopup, RdxMenuPortal, RdxMenuPortalMisuseGuard, RdxMenuPositioner, RdxMenuRadioGroup, RdxMenuRadioItem, RdxMenuRadioItemIndicator, RdxMenuRoot, RdxMenuSeparator, RdxMenuSubTrigger, RdxMenuTrigger, RdxMenuViewport, getCheckedState, injectRdxMenuCheckboxItemContext, injectRdxMenuGroupContext, injectRdxMenuRadioGroupContext, injectRdxMenuRadioItemContext, injectRdxMenuRootContext, isIndeterminate, provideRdxMenuCheckboxItemContext, provideRdxMenuGroupContext, provideRdxMenuRadioGroupContext, provideRdxMenuRadioItemContext, provideRdxMenuRootContext };
+export type { CheckedState, RdxMenuAutoFocus, RdxMenuAutoFocusInput, RdxMenuCheckboxChangeEvent, RdxMenuCheckboxItemContext, RdxMenuGroupContext, RdxMenuInstantType, RdxMenuOpenChange, RdxMenuOpenChangeEventDetails, RdxMenuOpenChangeReason, RdxMenuOrientation, RdxMenuParentType, RdxMenuRadioGroupContext, RdxMenuRadioGroupValueChangeEvent, RdxMenuRadioItemContext, RdxMenuRootContext, RdxMenuTransitionStatus, RdxMenuTriggerInteraction, RdxMenuTriggerInteractionHandler };

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

@@ -9,6 +9,7 @@ interface RdxMenubarContext {
     activeId: Signal<string | null>;
     isAnyOpen: Signal<boolean>;
     disabled: Signal<boolean>;
+    modal: Signal<boolean>;
     orientation: Signal<RdxMenubarOrientation>;
     registerItem: (id: string, el: HTMLElement, open: () => void, close: () => void, disabled: () => boolean) => () => void;
     activateItem: (id: string) => void;
@@ -32,12 +33,16 @@ declare class RdxMenubarRoot {
     private readonly itemsVersion;
     /** Whether every menubar trigger is disabled. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
+    /** Whether the child menus block outside interaction and lock scroll while open (Base UI default `true`). */
+    readonly modal: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
     /** Whether arrow-key navigation wraps at the first/last trigger. */
     readonly loopFocus: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
     /** The menubar orientation. */
     readonly orientation: _angular_core.InputSignal<RdxMenubarOrientation>;
     readonly activeId: _angular_core.WritableSignal<string | null>;
     readonly isAnyOpen: Signal<boolean>;
+    /** Whether a **nested submenu** is currently open (Base UI `data-has-submenu-open` — not top-level menus). */
+    readonly hasSubmenuOpen: Signal<boolean>;
     constructor();
     registerItem(id: string, el: HTMLElement, open: () => void, close: () => void, disabled: () => boolean): () => void;
     activateItem(id: string): void;
@@ -61,7 +66,7 @@ declare class RdxMenubarRoot {
     private syncDisabledIndices;
     private syncTabIndices;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxMenubarRoot, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxMenubarRoot, "[rdxMenubarRoot]", ["rdxMenubarRoot"], { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loopFocus": { "alias": "loopFocus"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; }, {}, ["menuRoots"], never, true, [{ directive: typeof i1.RdxCompositeRoot; inputs: {}; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxMenubarRoot, "[rdxMenubarRoot]", ["rdxMenubarRoot"], { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "modal": { "alias": "modal"; "required": false; "isSignal": true; }; "loopFocus": { "alias": "loopFocus"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; }, {}, ["menuRoots"], never, true, [{ directive: typeof i1.RdxCompositeRoot; inputs: {}; outputs: {}; }]>;
 }
 
 declare class RdxMenubarModule {

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

@@ -42,7 +42,7 @@ declare class RdxNavigationMenuPortalMisuseGuard {
 
 type NavigationMenuOrientation = 'horizontal' | 'vertical';
 type NavigationMenuDirection = 'ltr' | 'rtl';
-type RdxNavigationMenuOpenChangeReason = 'trigger-hover' | 'trigger-press' | 'list-navigation' | 'outside-press' | 'focus-out' | 'escape-key' | 'link-select' | 'list-leave' | 'none';
+type RdxNavigationMenuOpenChangeReason = 'trigger-hover' | 'trigger-press' | 'list-navigation' | 'outside-press' | 'focus-out' | 'escape-key' | 'link-press' | 'list-leave' | 'none';
 type RdxNavigationMenuOpenChangeEventDetails = RdxCancelableChangeEventDetails<RdxNavigationMenuOpenChangeReason>;
 interface RdxNavigationMenuOpenChange {
     value: string | null;
@@ -237,10 +237,10 @@ declare class RdxNavigationMenuList {
  */
 declare class RdxNavigationMenuItem {
     private readonly rootContext;
-    /**
-     * A unique value that identifies the item. Falls back to a generated id.
-     */
-    readonly value: _angular_core.InputSignalWithTransform<string, string | undefined>;
+    /** A unique value that identifies the item. Falls back to a stable generated id. */
+    readonly valueInput: _angular_core.InputSignal<string | undefined>;
+    private readonly generatedValue;
+    readonly value: _angular_core.Signal<string>;
     /** The trigger element, set by the trigger directive. */
     readonly triggerRef: _angular_core.WritableSignal<HTMLElement | null>;
     /** Whether this item is the currently open one. */
@@ -248,7 +248,7 @@ declare class RdxNavigationMenuItem {
     readonly triggerId: _angular_core.Signal<string>;
     readonly contentId: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxNavigationMenuItem, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxNavigationMenuItem, "[rdxNavigationMenuItem]", ["rdxNavigationMenuItem"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxNavigationMenuItem, "[rdxNavigationMenuItem]", ["rdxNavigationMenuItem"], { "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -267,6 +267,8 @@ declare class RdxNavigationMenuTrigger {
      * Whether the content should also open when the trigger is hovered.
      */
     readonly openOnHover: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Whether the trigger is currently pressed (pointer down), for Base UI's `data-pressed`. */
+    protected readonly pressed: _angular_core.WritableSignal<boolean>;
     protected readonly open: _angular_core.Signal<boolean>;
     constructor();
     protected onClick(event: MouseEvent): void;

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

@@ -48,6 +48,12 @@ declare class RdxPopoverHandle<Payload = unknown> {
 declare function createRdxPopoverHandle<Payload = unknown>(): RdxPopoverHandle<Payload>;
 
 type RdxPopoverModal = boolean | 'trap-focus';
+/**
+ * Why the open/close happened instantly (no transition). Mirrors Base UI's `data-instant` value
+ * (`'click' | 'dismiss' | 'focus' | 'trigger-change'`) so consumers can disable transitions
+ * per-reason instead of only knowing that *some* instant change occurred.
+ */
+type RdxPopoverInstantType = 'click' | 'dismiss' | 'focus' | 'trigger-change';
 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 {
@@ -70,6 +76,7 @@ interface RdxPopoverRootContext {
     hasPopupClose: Signal<boolean>;
     isHoverActive: Signal<boolean>;
     instant: Signal<boolean>;
+    instantType: Signal<RdxPopoverInstantType | undefined>;
     openChangeReason: Signal<RdxPopoverOpenChangeReason>;
     isPointerDownOnTrigger: Signal<boolean>;
     /** Whether the current open was initiated by touch (ADR 0016 §3 — gates the anchored scroll lock). */
@@ -119,6 +126,7 @@ declare class RdxPopoverRoot {
     private readonly transition;
     readonly isHoverActive: _angular_core.WritableSignal<boolean>;
     readonly instant: _angular_core.WritableSignal<boolean>;
+    readonly instantType: _angular_core.WritableSignal<RdxPopoverInstantType | undefined>;
     readonly openChangeReason: _angular_core.WritableSignal<RdxPopoverOpenChangeReason>;
     readonly transitionStatus: Signal<RdxTransitionStatus>;
     /**
@@ -144,7 +152,7 @@ declare class RdxPopoverRoot {
     /**
      * Associates this root with detached trigger elements.
      */
-    readonly handle: _angular_core.InputSignal<RdxPopoverHandle<any> | undefined>;
+    readonly handle: _angular_core.InputSignal<RdxPopoverHandle<unknown> | undefined>;
     readonly contentId: string;
     readonly beforeContentFocusGuard: _angular_core.WritableSignal<HTMLElement | null>;
     readonly descriptionId: _angular_core.WritableSignal<string | undefined>;
@@ -200,7 +208,7 @@ declare class RdxPopoverTrigger {
     /**
      * Associates this trigger with a detached popover root.
      */
-    readonly handle: _angular_core.InputSignal<RdxPopoverHandle<any> | undefined>;
+    readonly handle: _angular_core.InputSignal<RdxPopoverHandle<unknown> | undefined>;
     /**
      * Data associated with this trigger while it is active.
      */
@@ -371,7 +379,7 @@ declare class RdxPopoverClose {
  * until its CSS animation or transition completes.
  */
 declare class RdxPopoverViewport {
-    private readonly rootContext;
+    protected readonly rootContext: _radix_ng_primitives_popover.RdxPopoverRootContext;
     private readonly elementRef;
     private readonly destroyRef;
     private previous;
@@ -397,4 +405,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, RdxPopoverOpenChangeEventDetails, RdxPopoverOpenChangeReason, RdxPopoverRootContext, RdxPopoverTransitionStatus };
+export type { RdxPopoverInstantType, RdxPopoverModal, RdxPopoverOpenChange, RdxPopoverOpenChangeEventDetails, RdxPopoverOpenChangeReason, RdxPopoverRootContext, RdxPopoverTransitionStatus };

package/types/radix-ng-primitives-preview-card.d.ts

@@ -46,6 +46,12 @@ declare class RdxPreviewCardHandle<Payload = unknown> {
 }
 declare function createRdxPreviewCardHandle<Payload = unknown>(): RdxPreviewCardHandle<Payload>;
 
+/**
+ * Why an open/close happened instantly (no transition). Mirrors Base UI's preview-card `data-instant`:
+ * `'focus'` (opened by focus) or `'dismiss'` (closed by pressing the trigger or Escape). Hover
+ * opens/closes and outside-press closes are animated (`undefined`).
+ */
+type RdxPreviewCardInstantType = 'dismiss' | 'focus';
 type RdxPreviewCardOpenChangeReason = 'trigger-hover' | 'trigger-focus' | 'trigger-press' | 'outside-press' | 'escape-key' | 'imperative-action' | 'none';
 type RdxPreviewCardOpenChangeEventDetails = RdxCancelableChangeEventDetails<RdxPreviewCardOpenChangeReason>;
 interface RdxPreviewCardOpenChange {
@@ -64,6 +70,8 @@ interface RdxPreviewCardRootContext {
     triggers: Signal<HTMLElement[]>;
     isHoverActive: Signal<boolean>;
     instant: Signal<boolean>;
+    /** Why the open/close was instant (Base UI `data-instant`), or `undefined` when it animates. */
+    instantType: Signal<RdxPreviewCardInstantType | undefined>;
     openChangeReason: Signal<RdxPreviewCardOpenChangeReason>;
     isPointerDownOnTrigger: Signal<boolean>;
     close: (reason?: RdxPreviewCardOpenChangeReason, event?: Event) => void;
@@ -128,7 +136,7 @@ declare class RdxPreviewCardRoot {
     /**
      * Associates this root with detached trigger elements.
      */
-    readonly handle: _angular_core.InputSignal<RdxPreviewCardHandle<any> | undefined>;
+    readonly handle: _angular_core.InputSignal<RdxPreviewCardHandle<unknown> | undefined>;
     readonly contentId: string;
     readonly trigger: _angular_core.WritableSignal<HTMLElement | undefined>;
     readonly triggers: _angular_core.WritableSignal<HTMLElement[]>;
@@ -139,8 +147,13 @@ declare class RdxPreviewCardRoot {
     readonly onOpenChangeComplete: _angular_core.OutputEmitterRef<boolean>;
     private readonly registeredTriggers;
     private readonly viewportTriggerChange;
-    readonly state: Signal<"open" | "closed">;
     readonly present: Signal<boolean>;
+    /**
+     * Base UI `data-instant` enum, derived from the instant flag + reason: `'focus'` for a focus open,
+     * `'dismiss'` for a trigger-press / Escape close, `undefined` otherwise — including an outside-press
+     * close and a trigger switch, which Base UI animates rather than marking instant.
+     */
+    readonly instantType: Signal<RdxPreviewCardInstantType | undefined>;
     constructor();
     show(trigger?: HTMLElement | undefined, payload?: unknown, triggerId?: string, reason?: RdxPreviewCardOpenChangeReason, event?: Event, fromHover?: boolean): void;
     close(reason?: RdxPreviewCardOpenChangeReason, event?: Event): void;
@@ -172,7 +185,7 @@ declare class RdxPreviewCardTrigger {
     /**
      * Associates this trigger with a detached preview-card root.
      */
-    readonly handle: _angular_core.InputSignal<RdxPreviewCardHandle<any> | undefined>;
+    readonly handle: _angular_core.InputSignal<RdxPreviewCardHandle<unknown> | undefined>;
     /**
      * Data associated with this trigger while it is active.
      */
@@ -298,7 +311,7 @@ declare class RdxPreviewCardArrow {
  * until its CSS animation or transition completes.
  */
 declare class RdxPreviewCardViewport {
-    private readonly rootContext;
+    protected readonly rootContext: _radix_ng_primitives_preview_card.RdxPreviewCardRootContext;
     private readonly elementRef;
     private readonly destroyRef;
     private previous;
@@ -324,4 +337,4 @@ declare class RdxPreviewCardModule {
 }
 
 export { RdxPreviewCardArrow, RdxPreviewCardBackdrop, RdxPreviewCardHandle, RdxPreviewCardModule, RdxPreviewCardPopup, RdxPreviewCardPortal, RdxPreviewCardPortalMisuseGuard, RdxPreviewCardPositioner, RdxPreviewCardRoot, RdxPreviewCardTrigger, RdxPreviewCardViewport, createRdxPreviewCardHandle, injectRdxPreviewCardRootContext, previewCardImports, provideRdxPreviewCardRootContext };
-export type { RdxPreviewCardOpenChange, RdxPreviewCardOpenChangeEventDetails, RdxPreviewCardOpenChangeReason, RdxPreviewCardRootContext, RdxPreviewCardTransitionStatus };
+export type { RdxPreviewCardInstantType, RdxPreviewCardOpenChange, RdxPreviewCardOpenChangeEventDetails, RdxPreviewCardOpenChangeReason, RdxPreviewCardRootContext, RdxPreviewCardTransitionStatus };