@wix/site-ui 1.29.0 → 1.31.0

package/dist/PreviewCard/index.d.ts

@@ -1,23 +1,478 @@
+import { FloatingRootContext as FloatingRootContext_2 } from '../../floating-ui-react/index.js';
+import { FloatingRootStore as FloatingRootStore_2 } from '../../floating-ui-react/components/FloatingRootStore.js';
+import { HTMLProps as HTMLProps_2 } from '../../index.js';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
-import { PreviewCard as PreviewCard_2 } from '@base-ui/react/preview-card';
-import { PreviewCardArrowProps } from '@base-ui/react/preview-card';
-import { PreviewCardBackdropProps } from '@base-ui/react/preview-card';
-import { PreviewCardPopupProps } from '@base-ui/react/preview-card';
-import { PreviewCardPortalProps } from '@base-ui/react/preview-card';
-import { PreviewCardPositionerProps } from '@base-ui/react/preview-card';
+import { Padding } from '@floating-ui/react-dom';
+import { PreviewCardArrowProps as PreviewCardArrowProps_2 } from '@base-ui/react/preview-card';
+import { PreviewCardBackdropProps as PreviewCardBackdropProps_2 } from '@base-ui/react/preview-card';
+import { PreviewCardPopupProps as PreviewCardPopupProps_2 } from '@base-ui/react/preview-card';
+import { PreviewCardPortalProps as PreviewCardPortalProps_2 } from '@base-ui/react/preview-card';
+import { PreviewCardPositionerProps as PreviewCardPositionerProps_2 } from '@base-ui/react/preview-card';
 import * as React_2 from 'react';
+import { ReactStore } from '@base-ui/utils/store';
+import { Rect } from '@floating-ui/utils';
+import { TransitionStatus as TransitionStatus_2 } from '../../internals/useTransitionStatus.js';
+import type { UseFloatingReturn } from '@floating-ui/react-dom';
+import { VirtualElement } from '@floating-ui/react-dom';
+
+declare type Align = 'start' | 'center' | 'end';
+
+declare type BaseUIChangeEventDetail<Reason extends string, CustomProperties extends object> = {
+    /**
+     * The reason for the event.
+     */
+    reason: Reason;
+    /**
+     * The native event associated with the custom event.
+     */
+    event: ReasonToEvent<Reason>;
+    /**
+     * Cancels Base UI from handling the event.
+     */
+    cancel: () => void;
+    /**
+     * Allows the event to propagate in cases where Base UI will stop the propagation.
+     */
+    allowPropagation: () => void;
+    /**
+     * Indicates whether the event has been canceled.
+     */
+    isCanceled: boolean;
+    /**
+     * Indicates whether the event is allowed to propagate.
+     */
+    isPropagationAllowed: boolean;
+    /**
+     * The element that triggered the event, if applicable.
+     */
+    trigger: Element | undefined;
+} & CustomProperties;
+
+/**
+ * Details of custom change events emitted by Base UI components.
+ */
+declare type BaseUIChangeEventDetails<Reason extends string, CustomProperties extends object = {}> = Reason extends string ? BaseUIChangeEventDetail<Reason, CustomProperties> & {} : never;
+
+/**
+ * Props shared by all Base UI components.
+ * Contains `className` (string or callback taking the component's state as an argument) and `render` (function to customize rendering).
+ */
+declare type BaseUIComponentProps<ElementType extends React_2.ElementType, State, RenderFunctionProps = HTMLProps> = Omit<WithBaseUIEvent<React_2.ComponentPropsWithRef<ElementType>>, 'className' | 'color' | 'defaultValue' | 'defaultChecked' | 'style'> & {
+    /**
+     * CSS class applied to the element, or a function that
+     * returns a class based on the component's state.
+     */
+    className?: string | ((state: State) => string | undefined) | undefined;
+    /**
+     * Allows you to replace the component's HTML element
+     * with a different tag, or compose it with another component.
+     *
+     * Accepts a `ReactElement` or a function that returns the element to render.
+     */
+    render?: React_2.ReactElement | ComponentRenderFn<RenderFunctionProps, State> | undefined;
+    /**
+     * Style applied to the element, or a function that
+     * returns a style object based on the component's state.
+     */
+    style?: React_2.CSSProperties | ((state: State) => React_2.CSSProperties | undefined) | undefined;
+};
+
+declare type BaseUIEvent<E extends React_2.SyntheticEvent<Element, Event>> = E & {
+    preventBaseUIHandler: () => void;
+    readonly baseUIHandlerPrevented?: boolean | undefined;
+};
+
+declare type Boundary = 'clipping-ancestors' | Element | Element[] | Rect;
+
+declare const cancelOpen: "cancel-open";
+
+declare const chipRemovePress: "chip-remove-press";
+
+declare const clearPress: "clear-press";
+
+declare const closePress: "close-press";
+
+declare const closeWatcher: "close-watcher";
+
+declare type CollisionAvoidance = SideFlipMode | SideShiftMode;
+
+/**
+ * Shape of the render prop: a function that takes props to be spread on the element and component's state and returns a React element.
+ *
+ * @template Props Props to be spread on the rendered element.
+ * @template State Component's internal state.
+ */
+declare type ComponentRenderFn<Props, State> = (props: Props, state: State) => React_2.ReactElement<unknown>;
+
+declare type Context = PopupStoreContext<PreviewCardRoot.ChangeEventDetails> & {
+    closeDelayRef: React_2.RefObject<number>;
+    inlineRectCoordsRef: React_2.MutableRefObject<InlineRectCoords | undefined>;
+};
+
+declare interface ContextData {
+    openEvent?: Event | undefined;
+    floatingContext?: FloatingContext | undefined;
+    [key: string]: any;
+}
+
+/**
+ * Creates a new handle to connect a PreviewCard.Root with detached PreviewCard.Trigger components.
+ */
+declare function createPreviewCardHandle<Payload>(): PreviewCardHandle<Payload>;
+
+declare const decrementPress: "decrement-press";
+
+declare const disabled: "disabled";
+
+declare const drag: "drag";
+
+declare const escapeKey: "escape-key";
+
+declare interface ExtendedElements {
+    reference: ReferenceType | null;
+    floating: HTMLElement | null;
+    domReference: NarrowedElement<ReferenceType> | null;
+}
+
+declare interface ExtendedRefs {
+    reference: React_2.RefObject<ReferenceType | null>;
+    floating: React_2.RefObject<HTMLElement | null>;
+    domReference: React_2.RefObject<NarrowedElement<ReferenceType> | null>;
+    setReference(node: ReferenceType | null): void;
+    setFloating(node: HTMLElement | null): void;
+    setPositionReference(node: ReferenceType | null): void;
+}
+
+declare type FloatingContext = Omit<UseFloatingReturn<ReferenceType>, 'refs' | 'elements'> & {
+    open: boolean;
+    onOpenChange(open: boolean, eventDetails: BaseUIChangeEventDetails<string>): void;
+    events: FloatingEvents;
+    dataRef: React_2.RefObject<ContextData>;
+    nodeId: string | undefined;
+    floatingId: string | undefined;
+    refs: ExtendedRefs;
+    elements: ExtendedElements;
+    rootStore: FloatingRootContext;
+};
+
+declare interface FloatingEvents {
+    emit<T extends string>(event: T, data?: any): void;
+    on(event: string, handler: (data: any) => void): void;
+    off(event: string, handler: (data: any) => void): void;
+}
+
+/**
+ * Portals the floating element into a given container element — by default,
+ * outside of the app root and into the body.
+ * This is necessary to ensure the floating element can appear outside any
+ * potential parent containers that cause clipping (such as `overflow: hidden`),
+ * while retaining its location in the React tree.
+ * @see https://floating-ui.com/docs/FloatingPortal
+ * @internal
+ */
+declare const FloatingPortal: React_2.ForwardRefExoticComponent<Omit<FloatingPortal.Props<any> & {
+    renderGuards?: boolean | undefined;
+}, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+declare namespace FloatingPortal {
+    type State = FloatingPortalState;
+    interface Props<TState> extends BaseUIComponentProps<'div', TState> {
+        /**
+         * A parent element to render the portal element into.
+         */
+        container?: UseFloatingPortalNodeProps['container'] | undefined;
+    }
+}
+
+/**
+ * `FloatingPortal` includes tabbable logic handling for focus management.
+ * For components that don't need tabbable logic, use `FloatingPortalLite`.
+ * @internal
+ */
+declare const FloatingPortalLite: React_2.ForwardRefExoticComponent<Omit<FloatingPortalLite.Props<any>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+declare namespace FloatingPortalLite {
+    type State = FloatingPortalLiteState;
+    type Props<TState> = FloatingPortalLiteProps<TState>;
+}
+
+declare interface FloatingPortalLiteProps<TState> extends FloatingPortal.Props<TState> {}
+
+declare interface FloatingPortalLiteState {}
+
+declare interface FloatingPortalState {}
+
+declare type FloatingRootContext = FloatingRootStore;
+
+declare interface FloatingRootState {
+    open: boolean;
+    transitionStatus: TransitionStatus | undefined;
+    domReferenceElement: Element | null;
+    referenceElement: ReferenceType | null;
+    floatingElement: HTMLElement | null;
+    positionReference: ReferenceType | null;
+    /**
+     * The ID of the floating element.
+     */
+    floatingId: string | undefined;
+}
+
+declare class FloatingRootStore extends ReactStore<Readonly<FloatingRootState>, FloatingRootStoreContext, typeof selectors> {
+    private readonly syncOnly;
+    constructor(options: FloatingRootStoreOptions);
+    /**
+     * Syncs the event used by hover logic to distinguish hover-open from click-like interaction.
+     */
+    syncOpenEvent: (newOpen: boolean, event: Event | undefined) => void;
+    /**
+     * Runs the root-owned side effects for an open state change.
+     */
+    dispatchOpenChange: (newOpen: boolean, eventDetails: BaseUIChangeEventDetails<string>) => void;
+    /**
+     * Emits the `openchange` event through the internal event emitter and calls the `onOpenChange` handler with the provided arguments.
+     *
+     * @param newOpen The new open state.
+     * @param eventDetails Details about the event that triggered the open state change.
+     */
+    setOpen: (newOpen: boolean, eventDetails: BaseUIChangeEventDetails<string>) => void;
+}
+
+declare interface FloatingRootStoreContext {
+    onOpenChange: ((open: boolean, eventDetails: BaseUIChangeEventDetails<string>) => void) | undefined;
+    readonly dataRef: React_2.RefObject<ContextData>;
+    readonly events: FloatingEvents;
+    nested: boolean;
+    readonly triggerElements: PopupTriggerMap;
+}
+
+declare interface FloatingRootStoreOptions {
+    open: boolean;
+    transitionStatus: TransitionStatus | undefined;
+    referenceElement: ReferenceType | null;
+    floatingElement: HTMLElement | null;
+    triggerElements: PopupTriggerMap;
+    floatingId: string | undefined;
+    /**
+     * When true, `setOpen` only forwards to `onOpenChange`.
+     * The popup store owns `dispatchOpenChange(...)` in this mode.
+     */
+    syncOnly: boolean;
+    nested: boolean;
+    onOpenChange: ((open: boolean, eventDetails: BaseUIChangeEventDetails<string>) => void) | undefined;
+}
+
+declare const focusOut: "focus-out";
+
+declare type HTMLProps<T = any> = React_2.HTMLAttributes<T> & {
+    ref?: React_2.Ref<T> | undefined;
+};
+
+declare const imperativeAction: "imperative-action";
+
+declare const incrementPress: "increment-press";
+
+declare const initial: "initial";
+
+declare interface InlineRectCoords {
+    /** The x position in viewport coordinates. */
+    x: number;
+    /** The y position in viewport coordinates. */
+    y: number;
+    /** The line index under the pointer when coordinates were captured. */
+    lineIndex?: number | undefined;
+    /** The trigger element whose rects produced these coordinates. */
+    element: Element;
+}
+
+declare const inputBlur: "input-blur";
+
+declare const inputChange: "input-change";
+
+declare const inputClear: "input-clear";
+
+declare const inputPaste: "input-paste";
+
+declare const inputPress: "input-press";
+
+declare const itemPress: "item-press";
+
+declare const keyboard: "keyboard";
+
+declare const linkPress: "link-press";
+
+declare const listNavigation: "list-navigation";
+
+declare const missing: "missing";
+
+declare type NarrowedElement<T> = T extends Element ? T : Element;
+
+declare const none: "none";
+
+declare type OffsetFunction = (data: {
+    side: Side;
+    align: Align;
+    anchor: {
+        width: number;
+        height: number;
+    };
+    positioner: {
+        width: number;
+        height: number;
+    };
+}) => number;
+
+declare const outsidePress: "outside-press";
+
+declare type PayloadChildRenderFunction<Payload> = (arg: {
+    payload: Payload | undefined;
+}) => React_2.ReactNode;
+
+declare const pointer: "pointer";
+
+declare type PopupStoreContext<ChangeEventDetails> = {
+    /**
+     * Map of registered trigger elements.
+     */
+    readonly triggerElements: PopupTriggerMap;
+    /**
+     * Reference to the popup element.
+     */
+    readonly popupRef: React.RefObject<HTMLElement | null>;
+    /**
+     * Callback fired when the open state changes.
+     */
+    onOpenChange?: ((open: boolean, eventDetails: ChangeEventDetails) => void) | undefined;
+    /**
+     * Callback fired when the open state change animation completes.
+     */
+    onOpenChangeComplete: ((open: boolean) => void) | undefined;
+};
+
+/**
+ * State common to all popup stores.
+ */
+declare type PopupStoreState<Payload> = {
+    /**
+     * Whether the popup is open (internal state).
+     */
+    open: boolean;
+    /**
+     * Whether the popup is open (external prop).
+     */
+    readonly openProp: boolean | undefined;
+    /**
+     * Whether the popup should be mounted in the DOM.
+     * This usually follows `open` but can be different during exit transitions.
+     */
+    mounted: boolean;
+    /**
+     * The current enter/exit transition status of the popup.
+     */
+    transitionStatus: TransitionStatus;
+    floatingRootContext: FloatingRootContext;
+    floatingId: string | undefined;
+    /**
+     * Number of trigger elements currently registered for this popup.
+     */
+    triggerCount: number;
+    /**
+     * Whether to prevent unmounting the popup when closed.
+     * Useful for interacting with JS animation libraries that control unmounting themselves.
+     */
+    preventUnmountingOnClose: boolean;
+    /**
+     * Optional payload set by the trigger.
+     */
+    payload: Payload | undefined;
+    /**
+     * ID of the currently active trigger.
+     */
+    activeTriggerId: string | null;
+    /**
+     * The currently active trigger DOM element.
+     */
+    activeTriggerElement: Element | null;
+    /**
+     * ID of the trigger (external prop).
+     */
+    readonly triggerIdProp: string | null | undefined;
+    /**
+     * The popup DOM element.
+     */
+    popupElement: HTMLElement | null;
+    /**
+     * The positioner DOM element.
+     */
+    positionerElement: HTMLElement | null;
+    /**
+     * Props to spread onto the active trigger element.
+     */
+    activeTriggerProps: HTMLProps;
+    /**
+     * Props to spread onto inactive trigger elements.
+     */
+    inactiveTriggerProps: HTMLProps;
+    /**
+     * Props to spread onto the popup element.
+     */
+    popupProps: HTMLProps;
+};
+
+/**
+ * Data structure to keep track of popup trigger elements by their IDs.
+ * Uses both a set of Elements and a map of IDs to Elements for efficient lookups.
+ */
+declare class PopupTriggerMap {
+    private elementsSet;
+    private idMap;
+    constructor();
+    /**
+     * Adds a trigger element with the given ID.
+     *
+     * Note: The provided element is assumed to not be registered under multiple IDs.
+     */
+    add(id: string, element: Element): void;
+    /**
+     * Removes the trigger element with the given ID.
+     */
+    delete(id: string): void;
+    /**
+     * Whether the given element is registered as a trigger.
+     */
+    hasElement(element: Element): boolean;
+    /**
+     * Whether there is a registered trigger element matching the given predicate.
+     */
+    hasMatchingElement(predicate: (el: Element) => boolean): boolean;
+    /**
+     * Returns the trigger element associated with the given ID, or undefined if no such element exists.
+     */
+    getById(id: string): Element | undefined;
+    /**
+     * Returns an iterable of all registered trigger entries, where each entry is a tuple of [id, element].
+     */
+    entries(): IterableIterator<[string, Element]>;
+    /**
+     * Returns an iterable of all registered trigger elements.
+     */
+    elements(): IterableIterator<Element>;
+    /**
+     * Returns the number of registered trigger elements.
+     */
+    get size(): number;
+}
 
 export declare const PreviewCard: {
-    Positioner: React_2.ForwardRefExoticComponent<Omit<Omit<Omit<PreviewCardPositionerProps, "ref"> & React_2.RefAttributes<HTMLDivElement>, "ref">, "className"> & {
+    Positioner: React_2.ForwardRefExoticComponent<Omit<Omit<Omit<PreviewCardPositionerProps_2, "ref"> & React_2.RefAttributes<HTMLDivElement>, "ref">, "className"> & {
         className?: string | undefined;
     } & React_2.RefAttributes<HTMLDivElement>>;
-    Popup: React_2.ForwardRefExoticComponent<Omit<Omit<Omit<PreviewCardPopupProps, "ref"> & React_2.RefAttributes<HTMLDivElement>, "ref">, "className"> & {
+    Popup: React_2.ForwardRefExoticComponent<Omit<Omit<Omit<PreviewCardPopupProps_2, "ref"> & React_2.RefAttributes<HTMLDivElement>, "ref">, "className"> & {
         className?: string | undefined;
     } & React_2.RefAttributes<HTMLDivElement>>;
-    Arrow: React_2.ForwardRefExoticComponent<Omit<Omit<Omit<PreviewCardArrowProps, "ref"> & React_2.RefAttributes<HTMLDivElement>, "ref">, "className"> & {
+    Arrow: React_2.ForwardRefExoticComponent<Omit<Omit<Omit<PreviewCardArrowProps_2, "ref"> & React_2.RefAttributes<HTMLDivElement>, "ref">, "className"> & {
         className?: string | undefined;
     } & React_2.RefAttributes<HTMLDivElement>>;
-    Backdrop: React_2.ForwardRefExoticComponent<Omit<Omit<Omit<PreviewCardBackdropProps, "ref"> & React_2.RefAttributes<HTMLDivElement>, "ref">, "className"> & {
+    Backdrop: React_2.ForwardRefExoticComponent<Omit<Omit<Omit<PreviewCardBackdropProps_2, "ref"> & React_2.RefAttributes<HTMLDivElement>, "ref">, "className"> & {
         className?: string | undefined;
     } & React_2.RefAttributes<HTMLDivElement>>;
     Viewport: React_2.ForwardRefExoticComponent<Omit<Omit<Omit<PreviewCard_2.Viewport.Props, "ref"> & React_2.RefAttributes<HTMLDivElement>, "ref">, "className"> & {
@@ -25,18 +480,1072 @@ export declare const PreviewCard: {
     } & React_2.RefAttributes<HTMLDivElement>>;
     Root: <Payload>(props: PreviewCard_2.Root.Props<Payload>) => JSX_2.Element;
     Trigger: typeof Trigger;
-    Portal: React_2.ForwardRefExoticComponent<Omit<PreviewCardPortalProps, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+    Portal: React_2.ForwardRefExoticComponent<Omit<PreviewCardPortalProps_2, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
     Handle: typeof PreviewCard_2.Handle;
     createHandle: typeof PreviewCard_2.createHandle;
 };
 
+export declare namespace PreviewCard_2 {
+    export {
+        PreviewCardRoot as Root,
+        PreviewCardPortal as Portal,
+        PreviewCardTrigger as Trigger,
+        PreviewCardPositioner as Positioner,
+        PreviewCardPopup as Popup,
+        PreviewCardArrow as Arrow,
+        PreviewCardBackdrop as Backdrop,
+        PreviewCardViewport as Viewport,
+        createPreviewCardHandle as createHandle,
+        PreviewCardHandle as Handle
+    }
+}
+
+/**
+ * Displays an element positioned against the preview card anchor.
+ * Renders a `<div>` element.
+ *
+ * Documentation: [Base UI Preview Card](https://base-ui.com/react/components/preview-card)
+ */
+export declare const PreviewCardArrow: React_2.ForwardRefExoticComponent<Omit<PreviewCardArrowProps, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare namespace PreviewCardArrow {
+    export type State = PreviewCardArrowState;
+    export type Props = PreviewCardArrowProps;
+}
+
+export declare interface PreviewCardArrowProps extends BaseUIComponentProps<'div', PreviewCardArrowState> {}
+
+export declare interface PreviewCardArrowState {
+    /**
+     * Whether the preview card is currently open.
+     */
+    open: boolean;
+    /**
+     * The side of the anchor the component is placed on.
+     */
+    side: Side;
+    /**
+     * The alignment of the component relative to the anchor.
+     */
+    align: Align;
+    /**
+     * Whether the arrow cannot be centered on the anchor.
+     */
+    uncentered: boolean;
+}
+
+/**
+ * An overlay displayed beneath the popup.
+ * Renders a `<div>` element.
+ *
+ * Documentation: [Base UI Preview Card](https://base-ui.com/react/components/preview-card)
+ */
+export declare const PreviewCardBackdrop: React_2.ForwardRefExoticComponent<Omit<PreviewCardBackdropProps, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare namespace PreviewCardBackdrop {
+    export type State = PreviewCardBackdropState;
+    export type Props = PreviewCardBackdropProps;
+}
+
+export declare interface PreviewCardBackdropProps extends BaseUIComponentProps<'div', PreviewCardBackdropState> {}
+
+export declare interface PreviewCardBackdropState {
+    /**
+     * Whether the preview card is currently open.
+     */
+    open: boolean;
+    /**
+     * The transition status of the component.
+     */
+    transitionStatus: TransitionStatus;
+}
+
+/**
+ * A handle to control a preview card imperatively and to associate detached triggers with it.
+ */
+declare class PreviewCardHandle<Payload> {
+    /**
+     * Internal store holding the preview card state.
+     * @internal
+     */
+    readonly store: PreviewCardStore<Payload>;
+    constructor();
+    /**
+     * Opens the preview card and associates it with the trigger with the given ID.
+     * The trigger must be a PreviewCard.Trigger component with this handle passed as a prop.
+     *
+     * This method should only be called in an event handler or an effect (not during rendering).
+     *
+     * @param triggerId ID of the trigger to associate with the preview card.
+     */
+    open(triggerId: string): void;
+    /**
+     * Closes the preview card.
+     */
+    close(): void;
+    /**
+     * Indicates whether the preview card is currently open.
+     */
+    get isOpen(): boolean;
+}
+
+/**
+ * A container for the preview card contents.
+ * Renders a `<div>` element.
+ *
+ * Documentation: [Base UI Preview Card](https://base-ui.com/react/components/preview-card)
+ */
+export declare const PreviewCardPopup: React_2.ForwardRefExoticComponent<Omit<PreviewCardPopupProps, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare namespace PreviewCardPopup {
+    export type State = PreviewCardPopupState;
+    export type Props = PreviewCardPopupProps;
+}
+
+export declare interface PreviewCardPopupProps extends BaseUIComponentProps<'div', PreviewCardPopupState> {}
+
+export declare interface PreviewCardPopupState {
+    /**
+     * Whether the preview card is currently open.
+     */
+    open: boolean;
+    /**
+     * The side of the anchor the component is placed on.
+     */
+    side: Side;
+    /**
+     * The alignment of the component relative to the anchor.
+     */
+    align: Align;
+    /**
+     * Whether transitions should be skipped.
+     */
+    instant: 'dismiss' | 'focus' | undefined;
+    /**
+     * The transition status of the component.
+     */
+    transitionStatus: TransitionStatus;
+}
+
+/**
+ * A portal element that moves the popup to a different part of the DOM.
+ * By default, the portal element is appended to `<body>`.
+ * Renders a `<div>` element.
+ *
+ * Documentation: [Base UI Preview Card](https://base-ui.com/react/components/preview-card)
+ */
+export declare const PreviewCardPortal: React_2.ForwardRefExoticComponent<Omit<PreviewCardPortalProps, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare namespace PreviewCardPortal {
+    export type State = PreviewCardPortalState;
+    export type Props = PreviewCardPortalProps;
+}
+
+export declare interface PreviewCardPortalProps extends FloatingPortalLite.Props<PreviewCardPortalState> {
+    /**
+     * Whether to keep the portal mounted in the DOM while the popup is hidden.
+     * @default false
+     */
+    keepMounted?: boolean | undefined;
+}
+
+export declare interface PreviewCardPortalState {}
+
+/**
+ * Positions the popup against the trigger.
+ * Renders a `<div>` element.
+ *
+ * Documentation: [Base UI Preview Card](https://base-ui.com/react/components/preview-card)
+ */
+export declare const PreviewCardPositioner: React_2.ForwardRefExoticComponent<Omit<PreviewCardPositionerProps, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare namespace PreviewCardPositioner {
+    export type State = PreviewCardPositionerState;
+    export type Props = PreviewCardPositionerProps;
+}
+
+export declare interface PreviewCardPositionerProps extends UseAnchorPositioningSharedParameters, BaseUIComponentProps<'div', PreviewCardPositionerState> {}
+
+export declare interface PreviewCardPositionerState {
+    /**
+     * Whether the preview card is currently open.
+     */
+    open: boolean;
+    /**
+     * The side of the anchor the component is placed on.
+     */
+    side: Side;
+    /**
+     * The alignment of the component relative to the anchor.
+     */
+    align: Align;
+    /**
+     * Whether the anchor element is hidden.
+     */
+    anchorHidden: boolean;
+    /**
+     * Whether transitions should be skipped.
+     */
+    instant: 'dismiss' | 'focus' | undefined;
+}
+
+/**
+ * Groups all parts of the preview card.
+ * Doesn't render its own HTML element.
+ *
+ * Documentation: [Base UI Preview Card](https://base-ui.com/react/components/preview-card)
+ */
+export declare const PreviewCardRoot: <Payload>(props: PreviewCardRoot.Props<Payload>) => JSX_2.Element;
+
+export declare namespace PreviewCardRoot {
+    export type State = PreviewCardRootState;
+    export type Props<Payload = unknown> = PreviewCardRootProps<Payload>;
+    export type Actions = PreviewCardRootActions;
+    export type ChangeEventReason = PreviewCardRootChangeEventReason;
+    export type ChangeEventDetails = PreviewCardRootChangeEventDetails;
+}
+
+export declare interface PreviewCardRootActions {
+    unmount: () => void;
+    close: () => void;
+}
+
+export declare type PreviewCardRootChangeEventDetails = BaseUIChangeEventDetails<PreviewCardRoot.ChangeEventReason> & {
+    preventUnmountOnClose(): void;
+};
+
+export declare type PreviewCardRootChangeEventReason = typeof REASONS.triggerHover | typeof REASONS.triggerFocus | typeof REASONS.triggerPress | typeof REASONS.outsidePress | typeof REASONS.escapeKey | typeof REASONS.imperativeAction | typeof REASONS.none;
+
+export declare interface PreviewCardRootProps<Payload = unknown> {
+    /**
+     * Whether the preview card is initially open.
+     *
+     * To render a controlled preview card, use the `open` prop instead.
+     * @default false
+     */
+    defaultOpen?: boolean | undefined;
+    /**
+     * Whether the preview card is currently open.
+     */
+    open?: boolean | undefined;
+    /**
+     * Event handler called when the preview card is opened or closed.
+     */
+    onOpenChange?: ((open: boolean, eventDetails: PreviewCardRoot.ChangeEventDetails) => void) | undefined;
+    /**
+     * Event handler called after any animations complete when the preview card is opened or closed.
+     */
+    onOpenChangeComplete?: ((open: boolean) => void) | undefined;
+    /**
+     * A ref to imperative actions.
+     * - `unmount`: Unmounts the preview card popup.
+     * - `close`: Closes the preview card imperatively when called.
+     */
+    actionsRef?: React_2.RefObject<PreviewCardRoot.Actions | null> | undefined;
+    /**
+     * A handle to associate the preview card with a trigger.
+     * If specified, allows external triggers to control the card's open state.
+     * Can be created with the PreviewCard.createHandle() method.
+     */
+    handle?: PreviewCardHandle<Payload> | undefined;
+    /**
+     * The content of the preview card.
+     * This can be a regular React node or a render function that receives the `payload` of the active trigger.
+     */
+    children?: React_2.ReactNode | PayloadChildRenderFunction<Payload>;
+    /**
+     * ID of the trigger that the preview card is associated with.
+     * This is useful in conjunction with the `open` prop to create a controlled preview card.
+     * There's no need to specify this prop when the preview card is uncontrolled (that is, when the `open` prop is not set).
+     */
+    triggerId?: string | null | undefined;
+    /**
+     * ID of the trigger that the preview card is associated with.
+     * This is useful in conjunction with the `defaultOpen` prop to create an initially open preview card.
+     */
+    defaultTriggerId?: string | null | undefined;
+}
+
+export declare interface PreviewCardRootState {}
+
+declare class PreviewCardStore<Payload> extends ReactStore<Readonly<State<Payload>>, Context, typeof selectors_2> {
+    constructor(initialState?: Partial<State<Payload>>, floatingId?: string | undefined, nested?: boolean);
+    setOpen: (nextOpen: boolean, eventDetails: Omit<PreviewCardRoot.ChangeEventDetails, "preventUnmountOnClose">) => void;
+    static useStore<Payload>(externalStore: PreviewCardStore<Payload> | undefined, initialState?: Partial<State<Payload>>): PreviewCardStore<Payload>;
+}
+
+/**
+ * A link that opens the preview card.
+ * Renders an `<a>` element.
+ *
+ * Documentation: [Base UI Preview Card](https://base-ui.com/react/components/preview-card)
+ */
+export declare const PreviewCardTrigger: PreviewCardTrigger;
+
+export declare interface PreviewCardTrigger {
+    <Payload>(componentProps: PreviewCardTrigger.Props<Payload> & React_2.RefAttributes<HTMLElement>): React_2.JSX.Element;
+}
+
+export declare namespace PreviewCardTrigger {
+    export type State = PreviewCardTriggerState;
+    export type Props<Payload = unknown> = PreviewCardTriggerProps<Payload>;
+}
+
+export declare interface PreviewCardTriggerProps<Payload = unknown> extends BaseUIComponentProps<'a', PreviewCardTriggerState> {
+    /**
+     * A handle to associate the trigger with a preview card.
+     */
+    handle?: PreviewCardHandle<Payload> | undefined;
+    /**
+     * A payload to pass to the preview card when it is opened.
+     */
+    payload?: Payload | undefined;
+    /**
+     * How long to wait before the preview card opens. Specified in milliseconds.
+     * @default 600
+     */
+    delay?: number | undefined;
+    /**
+     * How long to wait before closing the preview card. Specified in milliseconds.
+     * @default 300
+     */
+    closeDelay?: number | undefined;
+}
+
+export declare interface PreviewCardTriggerState {
+    /**
+     * Whether the preview card is currently open.
+     */
+    open: boolean;
+}
+
+/**
+ * A viewport for displaying content transitions.
+ * This component is only required if one popup can be opened by multiple triggers, its content
+ * changes based on the trigger, and switching between them is animated.
+ * Renders a `<div>` element.
+ *
+ * Documentation: [Base UI Preview Card](https://base-ui.com/react/components/preview-card)
+ */
+export declare const PreviewCardViewport: React_2.ForwardRefExoticComponent<Omit<PreviewCardViewport.Props, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare namespace PreviewCardViewport {
+    export interface Props extends BaseUIComponentProps<'div', PreviewCardViewportState> {
+        /**
+         * The content to render inside the transition container.
+         */
+        children?: React_2.ReactNode;
+    }
+    export type State = PreviewCardViewportState;
+}
+
+export declare interface PreviewCardViewportState {
+    /**
+     * The activation direction of the transitioned content.
+     */
+    activationDirection: string | undefined;
+    /**
+     * Whether the viewport is currently transitioning between contents.
+     */
+    transitioning: boolean;
+    /**
+     * Present if animations should be instant.
+     */
+    instant: 'dismiss' | 'focus' | undefined;
+}
+
+declare namespace REASONS {
+    export {
+        none,
+        triggerPress,
+        triggerHover,
+        triggerFocus,
+        outsidePress,
+        itemPress,
+        closePress,
+        linkPress,
+        clearPress,
+        chipRemovePress,
+        trackPress,
+        incrementPress,
+        decrementPress,
+        inputChange,
+        inputClear,
+        inputBlur,
+        inputPaste,
+        inputPress,
+        focusOut,
+        escapeKey,
+        closeWatcher,
+        listNavigation,
+        keyboard,
+        pointer,
+        drag,
+        wheel,
+        scrub,
+        cancelOpen,
+        siblingOpen,
+        disabled,
+        missing,
+        initial,
+        imperativeAction,
+        swipe,
+        windowResize
+    }
+}
+
+/**
+ * Maps a change `reason` string to the corresponding native event type.
+ */
+declare type ReasonToEvent<Reason extends string> = Reason extends keyof ReasonToEventMap ? ReasonToEventMap[Reason] : Event;
+
+declare interface ReasonToEventMap {
+    [REASONS.none]: Event;
+    [REASONS.triggerPress]: MouseEvent | PointerEvent | TouchEvent | KeyboardEvent;
+    [REASONS.triggerHover]: MouseEvent;
+    [REASONS.triggerFocus]: FocusEvent;
+    [REASONS.outsidePress]: MouseEvent | PointerEvent | TouchEvent;
+    [REASONS.itemPress]: MouseEvent | KeyboardEvent | PointerEvent;
+    [REASONS.closePress]: MouseEvent | KeyboardEvent | PointerEvent;
+    [REASONS.linkPress]: MouseEvent | PointerEvent;
+    [REASONS.clearPress]: PointerEvent | MouseEvent | KeyboardEvent;
+    [REASONS.chipRemovePress]: PointerEvent | MouseEvent | KeyboardEvent;
+    [REASONS.trackPress]: PointerEvent | MouseEvent | TouchEvent;
+    [REASONS.incrementPress]: PointerEvent | MouseEvent | TouchEvent;
+    [REASONS.decrementPress]: PointerEvent | MouseEvent | TouchEvent;
+    [REASONS.inputChange]: InputEvent | Event;
+    [REASONS.inputClear]: InputEvent | FocusEvent | Event;
+    [REASONS.inputBlur]: FocusEvent;
+    [REASONS.inputPaste]: ClipboardEvent;
+    [REASONS.inputPress]: MouseEvent | PointerEvent | TouchEvent | KeyboardEvent;
+    [REASONS.focusOut]: FocusEvent | KeyboardEvent;
+    [REASONS.escapeKey]: KeyboardEvent;
+    [REASONS.closeWatcher]: Event;
+    [REASONS.listNavigation]: KeyboardEvent;
+    [REASONS.keyboard]: KeyboardEvent;
+    [REASONS.pointer]: PointerEvent;
+    [REASONS.drag]: PointerEvent | TouchEvent;
+    [REASONS.swipe]: PointerEvent | TouchEvent;
+    [REASONS.wheel]: WheelEvent;
+    [REASONS.scrub]: PointerEvent;
+    [REASONS.cancelOpen]: MouseEvent;
+    [REASONS.siblingOpen]: Event;
+    [REASONS.disabled]: Event;
+    [REASONS.missing]: Event;
+    [REASONS.initial]: Event;
+    [REASONS.imperativeAction]: Event;
+    [REASONS.windowResize]: UIEvent;
+}
+
+declare type ReferenceType = Element | VirtualElement;
+
+declare const scrub: "scrub";
+
+declare const selectors: {
+    open: (state: FloatingRootState) => boolean;
+    transitionStatus: (state: FloatingRootState) => TransitionStatus;
+    domReferenceElement: (state: FloatingRootState) => Element | null;
+    referenceElement: (state: FloatingRootState) => ReferenceType | null;
+    floatingElement: (state: FloatingRootState) => HTMLElement | null;
+    floatingId: (state: FloatingRootState) => string | undefined;
+};
+
+declare const selectors_2: {
+    instantType: (state: State<unknown>) => "focus" | "dismiss" | undefined;
+    hasViewport: (state: State<unknown>) => boolean;
+    open: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }) => boolean;
+    mounted: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }) => boolean;
+    transitionStatus: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }) => TransitionStatus_2;
+    floatingRootContext: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }) => FloatingRootStore_2;
+    triggerCount: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }) => number;
+    preventUnmountingOnClose: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }) => boolean;
+    payload: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }) => unknown;
+    activeTriggerId: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }) => string | null;
+    activeTriggerElement: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }) => Element | null;
+    popupId: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }) => string | undefined;
+    isTriggerActive: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }, triggerId: string | undefined) => boolean;
+    isOpenedByTrigger: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }, triggerId: string | undefined) => boolean;
+    isMountedByTrigger: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }, triggerId: string | undefined) => boolean;
+    triggerProps: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }, isActive: boolean) => HTMLProps_2;
+    triggerPopupId: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }, triggerId: string | undefined) => string | undefined;
+    popupProps: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }) => HTMLProps_2;
+    popupElement: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }) => HTMLElement | null;
+    positionerElement: (state: {
+        open: boolean;
+        readonly openProp: boolean | undefined;
+        mounted: boolean;
+        transitionStatus: TransitionStatus_2;
+        floatingRootContext: FloatingRootContext_2;
+        floatingId: string | undefined;
+        triggerCount: number;
+        preventUnmountingOnClose: boolean;
+        payload: unknown;
+        activeTriggerId: string | null;
+        activeTriggerElement: Element | null;
+        readonly triggerIdProp: string | null | undefined;
+        popupElement: HTMLElement | null;
+        positionerElement: HTMLElement | null;
+        activeTriggerProps: HTMLProps_2;
+        inactiveTriggerProps: HTMLProps_2;
+        popupProps: HTMLProps_2;
+    }) => HTMLElement | null;
+};
+
+declare const siblingOpen: "sibling-open";
+
+declare type Side = 'top' | 'bottom' | 'left' | 'right' | 'inline-end' | 'inline-start';
+
+declare interface SideFlipMode {
+    /**
+     * How to avoid collisions on the side axis.
+     * - `'flip'`: If there is not enough space, place the popup on the opposite side.
+     * - `'none'`: Keep the preferred side even if it overflows.
+     */
+    side?: 'flip' | 'none' | undefined;
+    /**
+     * How to avoid collisions on the align axis.
+     * - `'flip'`: If there is not enough space, swap `'start'` and `'end'` alignment.
+     * - `'shift'`: Keep the alignment and shift the popup to fit within the boundary.
+     * - `'none'`: Keep the preferred alignment even if it overflows.
+     */
+    align?: 'flip' | 'shift' | 'none' | undefined;
+    /**
+     * If both sides on the preferred axis do not fit, determines whether to fallback
+     * to a side on the perpendicular axis and which logical side to prefer.
+     * - `'start'`: Prefer the logical start side on the perpendicular axis.
+     * - `'end'`: Prefer the logical end side on the perpendicular axis.
+     * - `'none'`: Do not fallback to the perpendicular axis.
+     */
+    fallbackAxisSide?: 'start' | 'end' | 'none' | undefined;
+}
+
+declare interface SideShiftMode {
+    /**
+     * How to avoid collisions on the side axis.
+     * - `'shift'`: Keep the preferred side and shift the popup to fit within the boundary.
+     * - `'none'`: Keep the preferred side even if it overflows.
+     */
+    side?: 'shift' | 'none' | undefined;
+    /**
+     * How to avoid collisions on the align axis.
+     * - `'shift'`: Keep the alignment and shift the popup to fit within the boundary.
+     * - `'none'`: Keep the preferred alignment even if it overflows.
+     */
+    align?: 'shift' | 'none' | undefined;
+    /**
+     * If both sides on the preferred axis do not fit, determines whether to fallback
+     * to a side on the perpendicular axis and which logical side to prefer.
+     * - `'start'`: Prefer the logical start side on the perpendicular axis.
+     * - `'end'`: Prefer the logical end side on the perpendicular axis.
+     * - `'none'`: Do not fallback to the perpendicular axis.
+     */
+    fallbackAxisSide?: 'start' | 'end' | 'none' | undefined;
+}
+
+declare type State<Payload> = PopupStoreState<Payload> & {
+    instantType: 'dismiss' | 'focus' | undefined;
+    hasViewport: boolean;
+};
+
+declare const swipe: "swipe";
+
+declare const trackPress: "track-press";
+
+declare type TransitionStatus = 'starting' | 'ending' | 'idle' | undefined;
+
 declare function Trigger<Payload = unknown>({ className, ...props }: WithStringClassName<PreviewCard_2.Trigger.Props<Payload>> & React_2.RefAttributes<HTMLElement>): JSX_2.Element;
 
+declare const triggerFocus: "trigger-focus";
+
+declare const triggerHover: "trigger-hover";
+
+declare const triggerPress: "trigger-press";
+
+declare interface UseAnchorPositioningSharedParameters {
+    /**
+     * An element to position the popup against.
+     * By default, the popup will be positioned against the trigger.
+     */
+    anchor?: Element | null | VirtualElement | React_2.RefObject<Element | null> | (() => Element | VirtualElement | null) | undefined;
+    /**
+     * Determines which CSS `position` property to use.
+     * @default 'absolute'
+     */
+    positionMethod?: 'absolute' | 'fixed' | undefined;
+    /**
+     * Which side of the anchor element to align the popup against.
+     * May automatically change to avoid collisions.
+     * @default 'bottom'
+     */
+    side?: Side | undefined;
+    /**
+     * Distance between the anchor and the popup in pixels.
+     * Also accepts a function that returns the distance to read the dimensions of the anchor
+     * and positioner elements, along with its side and alignment.
+     *
+     * The function takes a `data` object parameter with the following properties:
+     * - `data.anchor`: the dimensions of the anchor element with properties `width` and `height`.
+     * - `data.positioner`: the dimensions of the positioner element with properties `width` and `height`.
+     * - `data.side`: which side of the anchor element the positioner is aligned against.
+     * - `data.align`: how the positioner is aligned relative to the specified side.
+     *
+     * @example
+     * ```jsx
+     * <Positioner
+     *   sideOffset={({ side, align, anchor, positioner }) => {
+     *     return side === 'top' || side === 'bottom'
+     *       ? anchor.height
+     *       : anchor.width;
+     *   }}
+     * />
+     * ```
+     *
+     * @default 0
+     */
+    sideOffset?: number | OffsetFunction | undefined;
+    /**
+     * How to align the popup relative to the specified side.
+     * @default 'center'
+     */
+    align?: Align | undefined;
+    /**
+     * Additional offset along the alignment axis in pixels.
+     * Also accepts a function that returns the offset to read the dimensions of the anchor
+     * and positioner elements, along with its side and alignment.
+     *
+     * The function takes a `data` object parameter with the following properties:
+     * - `data.anchor`: the dimensions of the anchor element with properties `width` and `height`.
+     * - `data.positioner`: the dimensions of the positioner element with properties `width` and `height`.
+     * - `data.side`: which side of the anchor element the positioner is aligned against.
+     * - `data.align`: how the positioner is aligned relative to the specified side.
+     *
+     * @example
+     * ```jsx
+     * <Positioner
+     *   alignOffset={({ side, align, anchor, positioner }) => {
+     *     return side === 'top' || side === 'bottom'
+     *       ? anchor.width
+     *       : anchor.height;
+     *   }}
+     * />
+     * ```
+     *
+     * @default 0
+     */
+    alignOffset?: number | OffsetFunction | undefined;
+    /**
+     * An element or a rectangle that delimits the area that the popup is confined to.
+     * @default 'clipping-ancestors'
+     */
+    collisionBoundary?: Boundary | undefined;
+    /**
+     * Additional space to maintain from the edge of the collision boundary.
+     * @default 5
+     */
+    collisionPadding?: Padding | undefined;
+    /**
+     * Whether to maintain the popup in the viewport after
+     * the anchor element was scrolled out of view.
+     * @default false
+     */
+    sticky?: boolean | undefined;
+    /**
+     * Minimum distance to maintain between the arrow and the edges of the popup.
+     *
+     * Use it to prevent the arrow element from hanging out of the rounded corners of a popup.
+     * @default 5
+     */
+    arrowPadding?: number | undefined;
+    /**
+     * Whether to disable the popup from tracking any layout shift of its positioning anchor.
+     * @default false
+     */
+    disableAnchorTracking?: boolean | undefined;
+    /**
+     * Determines how to handle collisions when positioning the popup.
+     *
+     * `side` controls overflow on the preferred placement axis (`top`/`bottom` or `left`/`right`):
+     * - `'flip'`: keep the requested side when it fits; otherwise try the opposite side
+     *   (`top` and `bottom`, or `left` and `right`).
+     * - `'shift'`: never change side; keep the requested side and move the popup within
+     *   the clipping boundary so it stays visible.
+     * - `'none'`: do not correct side-axis overflow.
+     *
+     * `align` controls overflow on the alignment axis (`start`/`center`/`end`):
+     * - `'flip'`: keep side, but swap `start` and `end` when the requested alignment overflows.
+     * - `'shift'`: keep side and requested alignment, then nudge the popup along the
+     *   alignment axis to fit.
+     * - `'none'`: do not correct alignment-axis overflow.
+     *
+     * `fallbackAxisSide` controls fallback behavior on the perpendicular axis when the
+     * preferred axis cannot fit:
+     * - `'start'`: allow perpendicular fallback and try the logical start side first
+     *   (`top` before `bottom`, or `left` before `right` in LTR).
+     * - `'end'`: allow perpendicular fallback and try the logical end side first
+     *   (`bottom` before `top`, or `right` before `left` in LTR).
+     * - `'none'`: do not fallback to the perpendicular axis.
+     *
+     * When `side` is `'shift'`, explicitly setting `align` only supports `'shift'` or `'none'`.
+     * If `align` is omitted, it defaults to `'flip'`.
+     *
+     * @example
+     * ```jsx
+     * <Positioner
+     *   collisionAvoidance={{
+     *     side: 'shift',
+     *     align: 'shift',
+     *     fallbackAxisSide: 'none',
+     *   }}
+     * />
+     * ```
+     *
+     */
+    collisionAvoidance?: CollisionAvoidance | undefined;
+}
+
+declare interface UseFloatingPortalNodeProps {
+    ref?: React_2.Ref<HTMLDivElement> | undefined;
+    container?: HTMLElement | ShadowRoot | null | React_2.RefObject<HTMLElement | ShadowRoot | null> | undefined;
+    componentProps?: UseRenderElementComponentProps<any> | undefined;
+    elementProps?: React_2.HTMLAttributes<HTMLDivElement> | undefined;
+}
+
+declare interface UseRenderElementComponentProps<State> {
+    /**
+     * The class name to apply to the rendered element.
+     * Can be a string or a function that accepts the state and returns a string.
+     */
+    className?: string | ((state: State) => string | undefined) | undefined;
+    /**
+     * The render prop or React element to override the default element.
+     */
+    render?: undefined | React_2.ReactElement | ComponentRenderFn<React_2.HTMLAttributes<any>, State>;
+    /**
+     * The style to apply to the rendered element.
+     * Can be a style object or a function that accepts the state and returns a style object.
+     */
+    style?: React_2.CSSProperties | ((state: State) => React_2.CSSProperties | undefined) | undefined;
+}
+
+declare const wheel: "wheel";
+
+declare const windowResize: "window-resize";
+
+/**
+ * Adds a `preventBaseUIHandler` method to all event handlers.
+ */
+declare type WithBaseUIEvent<T> = { [K in keyof T]: WithPreventBaseUIHandler<T[K]> };
+
+declare type WithPreventBaseUIHandler<T> = T extends ((event: infer E) => any) ? E extends React_2.SyntheticEvent<Element, Event> ? (event: BaseUIEvent<E>) => ReturnType<T> : T : T extends undefined ? undefined : T;
+
 declare type WithStringClassName<P> = Omit<P, 'className'> & {
     className?: string;
 };
 
-
-export * from "@base-ui/react/preview-card";
-
 export { }