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

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

@@ -2,11 +2,12 @@ import * as _angular_core from '@angular/core';
 import { InjectionToken, Provider, 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, NumberInput, RdxCancelableChangeEventDetails } 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_tooltip from '@radix-ng/primitives/tooltip';
-import * as i1$2 from '@radix-ng/primitives/dismissable-layer';
+import { RdxOutsidePressDomEvent } from '@radix-ng/primitives/dismissable-layer';
+import * as _radix_ng_primitives_floating_focus_manager from '@radix-ng/primitives/floating-focus-manager';
 
 /**
  * Structural directive that teleports the tooltip content into a container (default `document.body`)
@@ -77,6 +78,7 @@ declare function injectRdxTooltipConfig(): Required<RdxTooltipConfig>;
 interface RdxTooltipContext {
     contentId: string;
     isOpen: Signal<boolean>;
+    present: Signal<boolean>;
     /** Whether the tooltip opened/closed without waiting for the delay. */
     instant: Signal<boolean>;
     disabled: Signal<boolean>;
@@ -86,13 +88,16 @@ interface RdxTooltipContext {
     trigger: Signal<HTMLElement | undefined>;
     triggers: Signal<HTMLElement[]>;
     payload: Signal<unknown>;
-    open: (trigger?: HTMLElement, payload?: unknown) => void;
-    close: () => void;
+    open: (trigger?: HTMLElement, payload?: unknown, event?: Event) => void;
+    close: (reason?: RdxTooltipOpenChangeReason, event?: Event) => void;
+    openChangeReason: Signal<RdxTooltipOpenChangeReason>;
+    cancelPendingOpen: () => void;
+    closeHoverOpen: (event?: Event) => void;
     /** Closes after the resolved close delay (used when hover/focus is lost). */
-    closeDelayed: () => void;
+    closeDelayed: (event?: Event) => void;
     registerTrigger: (trigger: HTMLElement) => () => void;
     /** Hover entered a trigger — opens after the resolved delay (or instantly). */
-    onTriggerEnter: (trigger?: HTMLElement, payload?: unknown) => void;
+    onTriggerEnter: (trigger?: HTMLElement, payload?: unknown, event?: Event) => void;
     /** Hover left a trigger — cancels a pending open and closes when appropriate. */
     onTriggerLeave: () => void;
     setCursorPosition: (position: {
@@ -101,6 +106,12 @@ interface RdxTooltipContext {
     } | undefined) => void;
     setDelays: (delay: number | undefined, closeDelay: number | undefined) => void;
 }
+type RdxTooltipOpenChangeReason = 'trigger-hover' | 'trigger-focus' | 'trigger-press' | 'outside-press' | 'escape-key' | 'disabled' | 'imperative-action' | 'none';
+type RdxTooltipOpenChangeEventDetails = RdxCancelableChangeEventDetails<RdxTooltipOpenChangeReason>;
+interface RdxTooltipOpenChangeEvent {
+    open: boolean;
+    eventDetails: RdxTooltipOpenChangeEventDetails;
+}
 declare const injectRdxTooltipContext: _radix_ng_primitives_core.InjectContext<RdxTooltipContext>;
 declare const provideRdxTooltipContext: (useFactory: () => RdxTooltipContext) => _angular_core.Provider;
 declare class RdxTooltip {
@@ -109,6 +120,12 @@ declare class RdxTooltip {
     private readonly popper;
     private readonly destroyRef;
     private hasAppliedDefaultOpen;
+    /**
+     * Per-popup floating root context (ADR 0015) — the shared store the positioner's dismissal
+     * capability reads (`open`, `triggers`, the reference/floating elements). The tree node is
+     * registered by the positioner; this context exists independently so dismissal can read `open()`.
+     */
+    readonly floatingContext: RdxFloatingRootContext;
     /**
      * Whether the tooltip is currently open.
      */
@@ -146,7 +163,7 @@ declare class RdxTooltip {
     /**
      * Event handler called when the open state changes.
      */
-    readonly onOpenChange: _angular_core.OutputEmitterRef<boolean>;
+    readonly onOpenChange: _angular_core.OutputEmitterRef<RdxTooltipOpenChangeEvent>;
     readonly contentId: string;
     readonly trigger: _angular_core.WritableSignal<HTMLElement | undefined>;
     readonly triggers: _angular_core.WritableSignal<HTMLElement[]>;
@@ -155,7 +172,10 @@ declare class RdxTooltip {
         x: number;
         y: number;
     } | undefined>;
+    readonly openChangeReason: _angular_core.WritableSignal<RdxTooltipOpenChangeReason>;
+    private readonly preventUnmountOnClose;
     private readonly openedInstant;
+    private suppressNextOpenChangeEmit;
     /** Local instant window used when this tooltip is not inside a provider. */
     private readonly localInstant;
     private readonly instantGroup;
@@ -166,17 +186,20 @@ declare class RdxTooltip {
     private readonly resolvedCloseDelay;
     /** Whether the most recent open happened without the delay. */
     readonly instant: Signal<boolean>;
+    readonly present: Signal<boolean>;
     private readonly virtualAnchor;
     private readonly openTimer;
     private readonly closeTimer;
     constructor();
     /** Opens immediately, optionally switching the active trigger/payload. */
-    show(trigger?: HTMLElement | undefined, payload?: unknown): void;
-    close(): void;
+    show(trigger?: HTMLElement | undefined, payload?: unknown, event?: Event): void;
+    close(reason?: RdxTooltipOpenChangeReason, event?: Event): void;
+    cancelPendingOpen(): void;
+    closeHoverOpen(event?: Event): void;
     /** Closes after the resolved close delay, e.g. when the pointer or focus leaves. */
-    scheduleClose(): void;
+    scheduleClose(event?: Event): void;
     /** Hover/focus entered — open after the delay, or instantly within the instant window. */
-    onTriggerEnter(trigger?: HTMLElement | undefined, payload?: unknown): void;
+    onTriggerEnter(trigger?: HTMLElement | undefined, payload?: unknown, event?: Event): void;
     onTriggerLeave(): void;
     registerTrigger(trigger: HTMLElement): () => void;
     setCursorPosition(position: {
@@ -216,84 +239,35 @@ declare class RdxTooltipPopup {
 
 /**
  * Positions the tooltip popup against its trigger (or a custom anchor).
+ *
+ * A "thin" positioner (ADR 0012): it inherits the popper positioning surface (inputs, `placed`
+ * output, unified vars + placement attrs) from {@link RdxPopperContentWrapper} and adds tooltip's own
+ * concerns — Base UI-aligned defaults (`side: 'top'`) via the config provider, dismiss handling
+ * (ADR 0015 — inline {@link RdxDismiss} on the shared floating tree, dismissal-only with
+ * no focus manager), the cursor-follow pointer-through behavior (via the inherited `nonInteractive`
+ * signal), the open/closed state attributes, and the hover grace area.
  */
-declare class RdxTooltipPositioner {
+declare class RdxTooltipPositioner extends RdxPopperContentWrapper {
     protected readonly rootContext: _radix_ng_primitives_tooltip.RdxTooltipContext;
-    protected readonly wrapper: RdxPopperContentWrapper;
     private readonly destroyRef;
-    private readonly dismissableLayer;
-    private readonly elementRef;
-    /**
-     * An element to position the popup against. Defaults to the trigger.
-     */
-    readonly anchor: _angular_core.InputSignal<RdxPopperAnchorElement>;
-    /**
-     * The preferred side of the anchor to render against when open.
-     */
-    readonly side: _angular_core.InputSignal<"top" | "right" | "bottom" | "left">;
-    /**
-     * The distance in pixels from the anchor.
-     */
-    readonly sideOffset: _angular_core.InputSignalWithTransform<number, NumberInput>;
-    /**
-     * The preferred alignment against the anchor.
-     */
-    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>;
-    /**
-     * The padding between the arrow and the edges of the content.
-     */
-    readonly arrowPadding: _angular_core.InputSignalWithTransform<number, NumberInput>;
-    /**
-     * When `true`, overrides the `side` and `align` preferences to prevent collisions with boundary edges.
-     */
-    readonly avoidCollisions: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
-    /**
-     * The element used as the collision boundary.
-     */
-    readonly collisionBoundary: _angular_core.InputSignal<ElementRef<HTMLElement> | ElementRef<HTMLElement>[] | undefined>;
-    /**
-     * The 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 `align` axis.
-     */
-    readonly sticky: _angular_core.InputSignal<"partial" | "always">;
-    /**
-     * Whether to hide the content 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 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>;
+    private readonly floatingContext;
+    private readonly registration;
+    private readonly containerRef;
     /**
      * 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 `DismissableLayer`. Can be prevented.
+     * 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>;
     private readonly triggerEl;
     private readonly containerEl;
     private readonly graceArea;
     private readonly afterNextRender;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxTooltipPositioner, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxTooltipPositioner, "[rdxTooltipPositioner]", 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"; "escapeKeyDown": "escapeKeyDown"; "pointerDownOutside": "pointerDownOutside"; }, never, never, true, [{ directive: typeof i1$2.RdxDismissableLayer; inputs: {}; outputs: {}; }, { 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<RdxTooltipPositioner, "[rdxTooltipPositioner]", never, {}, { "escapeKeyDown": "escapeKeyDown"; "pointerDownOutside": "pointerDownOutside"; }, never, never, true, [{ directive: typeof _radix_ng_primitives_core.RdxFloatingNodeRegistration; inputs: {}; outputs: {}; }]>;
 }
 
 type TooltipInstantController = {
@@ -384,15 +358,22 @@ declare class RdxTooltipTrigger {
     protected readonly isDisabled: _angular_core.Signal<boolean>;
     /** Whether this specific trigger is the active anchor of an open tooltip. */
     protected readonly isOpen: _angular_core.Signal<boolean>;
+    protected readonly triggerInteraction: _radix_ng_primitives_floating_focus_manager.RdxTriggerInteraction;
     private readonly isPointerDown;
     private readonly hasPointerMoveOpened;
+    private readonly isNestedTriggerHovered;
+    private pointerType;
     constructor();
-    protected handleFocus(): void;
-    protected handleBlur(): void;
-    protected handleClick(): void;
+    protected handleFocus(event: FocusEvent): void;
+    protected handleBlur(event: FocusEvent): void;
+    protected handleClick(event: MouseEvent): void;
+    protected handlePointerEnter(event: PointerEvent): void;
     protected handlePointerMove(event: PointerEvent): void;
     protected handlePointerLeave(): void;
+    protected handleMouseOver(event: MouseEvent): void;
+    protected handleMouseLeave(): void;
     protected handlePointerDown(event: PointerEvent): Promise<void>;
+    private detectNestedTriggerHover;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxTooltipTrigger, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxTooltipTrigger, "[rdxTooltipTrigger]", never, { "handle": { "alias": "handle"; "required": false; "isSignal": true; }; "payload": { "alias": "payload"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "closeOnClick": { "alias": "closeOnClick"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "delay": { "alias": "delay"; "required": false; "isSignal": true; }; "closeDelay": { "alias": "closeDelay"; "required": false; "isSignal": true; }; "userOnPointerDown": { "alias": "rdxOnPointerDown"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1$1.RdxPopperAnchor; inputs: {}; outputs: {}; }]>;
 }
@@ -400,4 +381,4 @@ declare class RdxTooltipTrigger {
 declare const tooltipImports: (typeof RdxTooltipPortal)[];
 
 export { RdxTooltip, RdxTooltipArrow, RdxTooltipDefaultsToken, RdxTooltipHandle, RdxTooltipPopup, RdxTooltipPortal, RdxTooltipPortalMisuseGuard, RdxTooltipPositioner, RdxTooltipProvider, RdxTooltipTrigger, createRdxTooltipHandle, defaultTooltipConfig, injectRdxTooltipConfig, injectRdxTooltipContext, injectRdxTooltipProviderContext, provideRdxTooltipConfig, provideRdxTooltipContext, provideRdxTooltipProviderContext, tooltipImports };
-export type { RdxTooltipConfig, RdxTooltipContext, RdxTooltipProviderContext, RdxTrackCursorAxis };
+export type { RdxTooltipConfig, RdxTooltipContext, RdxTooltipOpenChangeEvent, RdxTooltipOpenChangeEventDetails, RdxTooltipOpenChangeReason, RdxTooltipProviderContext, RdxTrackCursorAxis };