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

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

@@ -2,11 +2,11 @@ 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 { BooleanInput, NumberInput } from '@radix-ng/primitives/core';
+import { RdxFloatingRootContext, BooleanInput, RdxCancelableChangeEventDetails, 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_preview_card from '@radix-ng/primitives/preview-card';
-import * as i2 from '@radix-ng/primitives/dismissable-layer';
+import { RdxOutsidePressDomEvent } from '@radix-ng/primitives/dismissable-layer';
 
 /**
  * Structural directive that teleports the preview-card content into a container (default
@@ -47,16 +47,19 @@ declare class RdxPreviewCardHandle<Payload = unknown> {
 declare function createRdxPreviewCardHandle<Payload = unknown>(): RdxPreviewCardHandle<Payload>;
 
 type RdxPreviewCardOpenChangeReason = 'trigger-hover' | 'trigger-focus' | 'trigger-press' | 'outside-press' | 'escape-key' | 'imperative-action' | 'none';
+type RdxPreviewCardOpenChangeEventDetails = RdxCancelableChangeEventDetails<RdxPreviewCardOpenChangeReason>;
 interface RdxPreviewCardOpenChange {
     open: boolean;
     triggerId: string | null;
     trigger: HTMLElement | undefined;
     reason: RdxPreviewCardOpenChangeReason;
     event: Event;
+    eventDetails: RdxPreviewCardOpenChangeEventDetails;
 }
 interface RdxPreviewCardRootContext {
     contentId: string;
     isOpen: Signal<boolean>;
+    present: Signal<boolean>;
     trigger: Signal<HTMLElement | undefined>;
     triggers: Signal<HTMLElement[]>;
     isHoverActive: Signal<boolean>;
@@ -87,6 +90,12 @@ type RdxPreviewCardTransitionStatus = 'starting' | 'ending' | undefined;
 declare class RdxPreviewCardRoot {
     private readonly popper;
     private readonly destroyRef;
+    /**
+     * Per-popup floating root context (ADR 0015) — the shared store the popup's dismissal capability
+     * reads (`open`, `triggers`, the reference/floating elements). The tree node is registered by the
+     * popup; this context exists independently so dismissal can read `open()`.
+     */
+    readonly floatingContext: RdxFloatingRootContext;
     /** Shared open/close transition state machine (completes on the real animationend). */
     private readonly transition;
     private hasAppliedDefaultOpen;
@@ -125,11 +134,13 @@ declare class RdxPreviewCardRoot {
     readonly triggers: _angular_core.WritableSignal<HTMLElement[]>;
     readonly payload: _angular_core.WritableSignal<unknown>;
     readonly isPointerDownOnTrigger: _angular_core.WritableSignal<boolean>;
+    private readonly preventUnmountOnClose;
     readonly onOpenChange: _angular_core.OutputEmitterRef<RdxPreviewCardOpenChange>;
     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?: RdxPreviewCardOpenChangeReason, event?: Event, fromHover?: boolean): void;
     close(reason?: RdxPreviewCardOpenChangeReason, event?: Event): void;
@@ -143,7 +154,7 @@ declare class RdxPreviewCardRoot {
     registerViewport(onTriggerChange: (previous: HTMLElement, next: HTMLElement) => void): () => boolean;
     registerTransitionElement(element: HTMLElement): () => void;
     private syncTriggerId;
-    private emitOpenChange;
+    private createOpenChangeEvent;
     private clearHoverTimers;
     private clearOpenTimer;
     private clearCloseTimer;
@@ -210,104 +221,60 @@ declare class RdxPreviewCardBackdrop {
 
 /**
  * Positions the preview-card 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 preview-card's
+ * own concerns — Base UI-aligned defaults via the config provider, the open/closed/instant state
+ * attributes, the deprecated `--radix-preview-card-*` aliases, and the grace-area hover bridge.
  */
-declare class RdxPreviewCardPositioner {
+declare class RdxPreviewCardPositioner extends RdxPopperContentWrapper {
     protected readonly rootContext: _radix_ng_primitives_preview_card.RdxPreviewCardRootContext;
-    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<RdxPreviewCardPositioner, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxPreviewCardPositioner, "[rdxPreviewCardPositioner]", 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<RdxPreviewCardPositioner, "[rdxPreviewCardPositioner]", never, {}, {}, never, never, true, never>;
 }
 
 /**
  * A container for the preview-card contents.
+ *
+ * **ADR 0015 migration** onto the new floating dismissal engine (dismissal-only — a preview-card has
+ * no focus manager, ADR 0017 §1). Escape, an outside press, and a focus-out all close it (the legacy's
+ * trigger-press preventDefault is now automatic: the trigger is the registered reference, so a press on
+ * it is "inside" and never fires `pointerDownOutside`). A focus-out while a pointer is held on the
+ * trigger is still vetoed.
  */
 declare class RdxPreviewCardPopup {
     protected readonly rootContext: _radix_ng_primitives_preview_card.RdxPreviewCardRootContext;
-    private readonly dismissableLayer;
+    private readonly host;
+    private readonly floatingContext;
+    private readonly registration;
     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>;
+    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.OutputRef<PointerEvent>;
+    readonly pointerDownOutside: _angular_core.OutputEmitterRef<RdxOutsidePressDomEvent>;
     /**
      * Event handler called when focus moves outside of the popup. Can be prevented.
      */
-    readonly focusOutside: _angular_core.OutputRef<FocusEvent>;
+    readonly focusOutside: _angular_core.OutputEmitterRef<FocusEvent>;
     /**
      * Event handler called when an interaction happens outside of the popup. Can be prevented.
      */
-    readonly interactOutside: _angular_core.OutputRef<PointerEvent | FocusEvent>;
+    readonly interactOutside: _angular_core.OutputEmitterRef<RdxOutsidePressDomEvent | FocusEvent>;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxPreviewCardPopup, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxPreviewCardPopup, "[rdxPreviewCardPopup]", never, {}, { "escapeKeyDown": "escapeKeyDown"; "pointerDownOutside": "pointerDownOutside"; "focusOutside": "focusOutside"; "interactOutside": "interactOutside"; }, never, never, true, [{ directive: typeof i1$1.RdxPopperContent; inputs: {}; outputs: {}; }, { directive: typeof i2.RdxDismissableLayer; inputs: {}; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxPreviewCardPopup, "[rdxPreviewCardPopup]", never, {}, { "escapeKeyDown": "escapeKeyDown"; "pointerDownOutside": "pointerDownOutside"; "focusOutside": "focusOutside"; "interactOutside": "interactOutside"; }, never, never, true, [{ directive: typeof i1$1.RdxPopperContent; inputs: {}; outputs: {}; }, { directive: typeof _radix_ng_primitives_core.RdxFloatingNodeRegistration; inputs: {}; outputs: {}; }]>;
 }
 
 /**
@@ -357,4 +324,4 @@ declare class RdxPreviewCardModule {
 }
 
 export { RdxPreviewCardArrow, RdxPreviewCardBackdrop, RdxPreviewCardHandle, RdxPreviewCardModule, RdxPreviewCardPopup, RdxPreviewCardPortal, RdxPreviewCardPortalMisuseGuard, RdxPreviewCardPositioner, RdxPreviewCardRoot, RdxPreviewCardTrigger, RdxPreviewCardViewport, createRdxPreviewCardHandle, injectRdxPreviewCardRootContext, previewCardImports, provideRdxPreviewCardRootContext };
-export type { RdxPreviewCardOpenChange, RdxPreviewCardOpenChangeReason, RdxPreviewCardRootContext, RdxPreviewCardTransitionStatus };
+export type { RdxPreviewCardOpenChange, RdxPreviewCardOpenChangeEventDetails, RdxPreviewCardOpenChangeReason, RdxPreviewCardRootContext, RdxPreviewCardTransitionStatus };

package/types/radix-ng-primitives-roving-focus.d.ts

@@ -9,7 +9,7 @@ declare function focusFirst(candidates: HTMLElement[], preventScroll?: boolean,
 
 declare const rootContext: () => {
     loop: _angular_core.Signal<boolean>;
-    dir: _angular_core.Signal<Direction>;
+    dir: _angular_core.Signal<_radix_ng_primitives_core.Direction>;
     orientation: _angular_core.Signal<Orientation>;
     currentTabStopId: _angular_core.ModelSignal<string | undefined>;
     focusableItems: _angular_core.WritableSignal<HTMLElement[]>;
@@ -21,7 +21,7 @@ declare const rootContext: () => {
 type RovingFocusGroupContext = ReturnType<typeof rootContext>;
 declare const injectRovingFocusGroupContext: _radix_ng_primitives_core.InjectContext<{
     loop: _angular_core.Signal<boolean>;
-    dir: _angular_core.Signal<Direction>;
+    dir: _angular_core.Signal<_radix_ng_primitives_core.Direction>;
     orientation: _angular_core.Signal<Orientation>;
     currentTabStopId: _angular_core.ModelSignal<string | undefined>;
     focusableItems: _angular_core.WritableSignal<HTMLElement[]>;
@@ -32,7 +32,7 @@ declare const injectRovingFocusGroupContext: _radix_ng_primitives_core.InjectCon
 }>;
 declare const provideRovingFocusGroupContext: (useFactory: () => {
     loop: _angular_core.Signal<boolean>;
-    dir: _angular_core.Signal<Direction>;
+    dir: _angular_core.Signal<_radix_ng_primitives_core.Direction>;
     orientation: _angular_core.Signal<Orientation>;
     currentTabStopId: _angular_core.ModelSignal<string | undefined>;
     focusableItems: _angular_core.WritableSignal<HTMLElement[]>;
@@ -55,7 +55,8 @@ declare class RdxRovingFocusGroupDirective {
     /**
      * The direction of navigation between items.
      */
-    readonly dirInput: _angular_core.InputSignal<Direction>;
+    readonly dirInput: _angular_core.InputSignal<Direction | undefined>;
+    private readonly effectiveDir;
     /**
      * Whether keyboard navigation should loop around
      */
@@ -85,7 +86,7 @@ declare class RdxRovingFocusGroupDirective {
     private readonly _orientation;
     readonly orientation: _angular_core.Signal<Orientation>;
     private readonly _dir;
-    readonly dir: _angular_core.Signal<Direction>;
+    readonly dir: _angular_core.Signal<_radix_ng_primitives_core.Direction>;
     private readonly _loop;
     readonly loop: _angular_core.Signal<boolean>;
     readonly focusableItems: _angular_core.WritableSignal<HTMLElement[]>;
@@ -121,7 +122,7 @@ declare class RdxRovingFocusItemDirective {
      */
     protected readonly rootContext: {
         loop: _angular_core.Signal<boolean>;
-        dir: _angular_core.Signal<_radix_ng_primitives_roving_focus.Direction>;
+        dir: _angular_core.Signal<_radix_ng_primitives_core.Direction>;
         orientation: _angular_core.Signal<_radix_ng_primitives_roving_focus.Orientation>;
         currentTabStopId: _angular_core.ModelSignal<string | undefined>;
         focusableItems: _angular_core.WritableSignal<HTMLElement[]>;

package/types/radix-ng-primitives-scroll-area.d.ts

@@ -83,7 +83,7 @@ declare class RdxScrollAreaRoot {
     private readonly destroyRef;
     readonly rootId: string;
     /** Text direction of the scroll area. Affects horizontal (RTL) scroll math. */
-    readonly dir: _angular_core.InputSignal<Direction>;
+    readonly dirInput: _angular_core.InputSignal<Direction | undefined>;
     readonly direction: Signal<Direction>;
     /**
      * The threshold in pixels that must be passed before the overflow edge attributes are applied.
@@ -135,7 +135,7 @@ declare class RdxScrollAreaRoot {
     onTouchModalityChange(event: PointerEvent): void;
     onPointerEnterOrMove(event: PointerEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxScrollAreaRoot, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxScrollAreaRoot, "[rdxScrollAreaRoot]", ["rdxScrollAreaRoot"], { "dir": { "alias": "dir"; "required": false; "isSignal": true; }; "overflowEdgeThreshold": { "alias": "overflowEdgeThreshold"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxScrollAreaRoot, "[rdxScrollAreaRoot]", ["rdxScrollAreaRoot"], { "dirInput": { "alias": "dir"; "required": false; "isSignal": true; }; "overflowEdgeThreshold": { "alias": "overflowEdgeThreshold"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 interface ScrollAreaViewportContext {