@wix/site-ui 1.185.0 → 1.187.0

package/dist/Toast/index.d.ts

@@ -0,0 +1,846 @@
+import { ForwardRefExoticComponent } from 'react';
+import { Padding } from '@floating-ui/react-dom';
+import * as React_2 from 'react';
+import { Rect } from '@floating-ui/utils';
+import { RefAttributes } from 'react';
+import { ToastRootProps as ToastRootProps_2 } from '@base-ui/react';
+import { ToastTitleProps as ToastTitleProps_2 } from '@base-ui/react';
+import { ToastViewportProps as ToastViewportProps_2 } from '@base-ui/react';
+import { VirtualElement } from '@floating-ui/react-dom';
+
+declare type Align = 'start' | 'center' | 'end';
+
+/**
+ * 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 CloseButton: React_2.ForwardRefExoticComponent<CloseProps & React_2.RefAttributes<HTMLButtonElement>>;
+
+declare type CloseProps = Omit<WithStringClassName<React_2.ComponentPropsWithoutRef<typeof Toast_2.Close>>, 'children'>;
+
+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>;
+
+/**
+ * Creates a new toast manager.
+ */
+export declare function createToastManager<Data extends object = any>(): ToastManager<Data>;
+
+/**
+ * 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 HTMLProps<T = any> = React_2.HTMLAttributes<T> & {
+    ref?: React_2.Ref<T> | undefined;
+};
+
+declare interface NativeButtonProps {
+    /**
+     * Whether the component renders a native `<button>` element when replacing it
+     * via the `render` prop.
+     * Set to `false` if the rendered element is not a button (for example, `<div>`).
+     * @default true
+     */
+    nativeButton?: boolean | undefined;
+}
+
+declare type OffsetFunction = (data: {
+    side: Side;
+    align: Align;
+    anchor: {
+        width: number;
+        height: number;
+    };
+    positioner: {
+        width: number;
+        height: number;
+    };
+}) => number;
+
+declare const Root: React_2.ForwardRefExoticComponent<Omit<Omit<Omit<ToastRootProps_2, "ref"> & React_2.RefAttributes<HTMLDivElement>, "ref">, "className"> & {
+    className?: string;
+} & {
+    skin?: string;
+} & React_2.RefAttributes<HTMLDivElement>>;
+
+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 const Title: React_2.ForwardRefExoticComponent<Omit<Omit<Omit<ToastTitleProps_2, "ref"> & React_2.RefAttributes<HTMLHeadingElement>, "ref">, "className"> & {
+    className?: string;
+} & React_2.RefAttributes<HTMLHeadingElement>>;
+
+export declare const Toast: ToastNamespace;
+
+export declare namespace Toast_2 {
+    export {
+        ToastProvider as Provider,
+        ToastViewport as Viewport,
+        ToastRoot as Root,
+        ToastContent as Content,
+        ToastDescription as Description,
+        ToastTitle as Title,
+        ToastClose as Close,
+        ToastAction as Action,
+        ToastPortal as Portal,
+        ToastPositioner as Positioner,
+        ToastArrow as Arrow,
+        useToastManager,
+        createToastManager
+    }
+}
+
+/**
+ * Performs an action when clicked.
+ * Renders a `<button>` element.
+ *
+ * Documentation: [Base UI Toast](https://base-ui.com/react/components/toast)
+ */
+export declare const ToastAction: React_2.ForwardRefExoticComponent<Omit<ToastActionProps, "ref"> & React_2.RefAttributes<HTMLButtonElement>>;
+
+export declare namespace ToastAction {
+    export type State = ToastActionState;
+    export type Props = ToastActionProps;
+}
+
+export declare interface ToastActionProps extends NativeButtonProps, BaseUIComponentProps<'button', ToastActionState> {}
+
+export declare interface ToastActionState {
+    /**
+     * The type of the toast.
+     */
+    type: string | undefined;
+}
+
+/**
+ * Displays an element positioned against the toast anchor.
+ * Renders a `<div>` element.
+ *
+ * Documentation: [Base UI Toast](https://base-ui.com/react/components/toast)
+ */
+export declare const ToastArrow: React_2.ForwardRefExoticComponent<Omit<ToastArrowProps, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare namespace ToastArrow {
+    export type State = ToastArrowState;
+    export type Props = ToastArrowProps;
+}
+
+export declare interface ToastArrowProps extends BaseUIComponentProps<'div', ToastArrowState> {}
+
+export declare interface ToastArrowState {
+    /**
+     * 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;
+}
+
+/**
+ * Closes the toast when clicked.
+ * Renders a `<button>` element.
+ *
+ * Documentation: [Base UI Toast](https://base-ui.com/react/components/toast)
+ */
+export declare const ToastClose: React_2.ForwardRefExoticComponent<Omit<ToastCloseProps, "ref"> & React_2.RefAttributes<HTMLButtonElement>>;
+
+export declare namespace ToastClose {
+    export type State = ToastCloseState;
+    export type Props = ToastCloseProps;
+}
+
+export declare interface ToastCloseProps extends NativeButtonProps, BaseUIComponentProps<'button', ToastCloseState> {}
+
+export declare interface ToastCloseState {
+    /**
+     * The type of the toast.
+     */
+    type: string | undefined;
+}
+
+/**
+ * A container for the contents of a toast.
+ * Renders a `<div>` element.
+ *
+ * Documentation: [Base UI Toast](https://base-ui.com/react/components/toast)
+ */
+export declare const ToastContent: React_2.ForwardRefExoticComponent<Omit<ToastContentProps, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare namespace ToastContent {
+    export type State = ToastContentState;
+    export type Props = ToastContentProps;
+}
+
+export declare interface ToastContentProps extends BaseUIComponentProps<'div', ToastContentState> {}
+
+export declare interface ToastContentState {
+    /**
+     * Whether the toast viewport is expanded.
+     */
+    expanded: boolean;
+    /**
+     * Whether the toast is behind the frontmost toast in the stack.
+     */
+    behind: boolean;
+}
+
+/**
+ * A description that describes the toast.
+ * Can be used as the default message for the toast when no title is provided.
+ * Renders a `<p>` element.
+ *
+ * Documentation: [Base UI Toast](https://base-ui.com/react/components/toast)
+ */
+export declare const ToastDescription: React_2.ForwardRefExoticComponent<Omit<ToastDescriptionProps, "ref"> & React_2.RefAttributes<HTMLParagraphElement>>;
+
+export declare namespace ToastDescription {
+    export type State = ToastDescriptionState;
+    export type Props = ToastDescriptionProps;
+}
+
+export declare interface ToastDescriptionProps extends BaseUIComponentProps<'p', ToastDescriptionState> {}
+
+export declare interface ToastDescriptionState {
+    /**
+     * The type of the toast.
+     */
+    type: string | undefined;
+}
+
+export declare interface ToastManager<Data extends object = any> {
+    ' subscribe': (listener: (data: ToastManagerEvent) => void) => () => void;
+    add: <T extends Data = Data>(options: ToastManagerAddOptions<T>) => string;
+    close: (id?: string) => void;
+    update: <T extends Data = Data>(id: string, updates: ToastManagerUpdateOptions<T>) => void;
+    promise: <Value, T extends Data = Data>(promiseValue: Promise<Value>, options: ToastManagerPromiseOptions<Value, T>) => Promise<Value>;
+}
+
+export declare interface ToastManagerAddOptions<Data extends object> extends Omit<ToastObject<Data>, 'id' | 'animation' | 'height' | 'ref' | 'limited' | 'updateKey'> {
+    /**
+     * The unique identifier for the toast. Adding a toast with an existing ID
+     * updates it in place and refreshes its auto-dismiss timer.
+     */
+    id?: string | undefined;
+}
+
+export declare interface ToastManagerEvent {
+    action: 'add' | 'close' | 'update' | 'promise';
+    options: any;
+}
+
+export declare interface ToastManagerPositionerProps extends Omit<ToastPositionerProps, 'anchor' | 'toast'> {
+    /**
+     * An element to position the toast against.
+     */
+    anchor?: Element | null | undefined;
+}
+
+export declare interface ToastManagerPromiseOptions<Value, Data extends object> {
+    loading: string | ToastManagerUpdateOptions<Data>;
+    success: string | ToastManagerUpdateOptions<Data> | ((result: Value) => string | ToastManagerUpdateOptions<Data>);
+    error: string | ToastManagerUpdateOptions<Data> | ((error: any) => string | ToastManagerUpdateOptions<Data>);
+}
+
+export declare interface ToastManagerUpdateOptions<Data extends object> extends Partial<Omit<ToastObject<Data>, 'id' | 'ref' | 'height' | 'transitionStatus' | 'limited' | 'updateKey'>> {}
+
+declare type ToastNamespace = {
+    Provider: typeof Toast_2.Provider;
+    Portal: typeof Toast_2.Portal;
+    Viewport: typeof Viewport;
+    Root: typeof Root;
+    Title: typeof Title;
+    Close: typeof CloseButton;
+    useToastManager: typeof Toast_2.useToastManager;
+};
+
+export declare interface ToastObject<Data extends object> {
+    /**
+     * The unique identifier for the toast.
+     */
+    id: string;
+    /**
+     * The ref for the toast.
+     */
+    ref?: React_2.RefObject<HTMLElement | null> | undefined;
+    /**
+     * The title of the toast.
+     */
+    title?: React_2.ReactNode;
+    /**
+     * The type of the toast. Used to conditionally style the toast,
+     * including conditionally rendering elements based on the type.
+     */
+    type?: string | undefined;
+    /**
+     * The description of the toast.
+     */
+    description?: React_2.ReactNode;
+    /**
+     * The amount of time (in ms) before the toast is auto dismissed.
+     * A value of `0` will prevent the toast from being dismissed automatically.
+     * @default 5000
+     */
+    timeout?: number | undefined;
+    /**
+     * The priority of the toast.
+     * - `low` - The toast will be announced politely.
+     * - `high` - The toast will be announced urgently.
+     * @default 'low'
+     */
+    priority?: 'low' | 'high' | undefined;
+    /**
+     * The transition status of the toast.
+     */
+    transitionStatus?: 'starting' | 'ending' | undefined;
+    /**
+     * A counter that increments whenever the toast is updated or upserted.
+     */
+    updateKey?: number | undefined;
+    /**
+     * Determines if the toast was limited because the toast limit was exceeded.
+     */
+    limited?: boolean | undefined;
+    /**
+     * The height of the toast.
+     */
+    height?: number | undefined;
+    /**
+     * Callback function to be called when the toast is closed.
+     */
+    onClose?: (() => void) | undefined;
+    /**
+     * Callback function to be called when the toast is removed from the list after any animations are complete when closed.
+     */
+    onRemove?: (() => void) | undefined;
+    /**
+     * The props for the action button.
+     */
+    actionProps?: React_2.ComponentPropsWithoutRef<'button'> | undefined;
+    /**
+     * The props forwarded to the toast positioner element when rendering anchored toasts.
+     */
+    positionerProps?: ToastManagerPositionerProps | undefined;
+    /**
+     * Custom data for the toast.
+     */
+    data?: Data | undefined;
+}
+
+/**
+ * A portal element that moves the viewport to a different part of the DOM.
+ * By default, the portal element is appended to `<body>`.
+ * Renders a `<div>` element.
+ *
+ * Documentation: [Base UI Toast](https://base-ui.com/react/components/toast)
+ */
+export declare const ToastPortal: ForwardRefExoticComponent<Omit<FloatingPortalLite.Props<any>, "ref"> & RefAttributes<HTMLDivElement>>;
+
+export declare namespace ToastPortal {
+    export type State = ToastPortalState;
+    export type Props = ToastPortalProps;
+}
+
+export declare interface ToastPortalProps extends FloatingPortalLite.Props<ToastPortalState> {}
+
+export declare interface ToastPortalState {}
+
+/**
+ * Positions the toast against the anchor.
+ * Renders a `<div>` element.
+ *
+ * Documentation: [Base UI Toast](https://base-ui.com/react/components/toast)
+ */
+export declare const ToastPositioner: React_2.ForwardRefExoticComponent<Omit<ToastPositionerProps, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare namespace ToastPositioner {
+    export type State = ToastPositionerState;
+    export type Props = ToastPositionerProps;
+}
+
+export declare interface ToastPositionerProps extends BaseUIComponentProps<'div', ToastPositionerState>, Omit<UseAnchorPositioningSharedParameters, 'side' | 'anchor'> {
+    /**
+     * An element to position the toast against.
+     */
+    anchor?: Element | null | undefined;
+    /**
+     * Which side of the anchor element to align the toast against.
+     * May automatically change to avoid collisions.
+     * @default 'top'
+     */
+    side?: Side | undefined;
+    /**
+     * The toast object associated with the positioner.
+     */
+    toast: ToastObject<any>;
+}
+
+export declare interface ToastPositionerState {
+    /**
+     * 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;
+}
+
+/**
+ * Provides a context for creating and managing toasts.
+ *
+ * Documentation: [Base UI Toast](https://base-ui.com/react/components/toast)
+ */
+export declare const ToastProvider: React_2.FC<ToastProvider.Props>;
+
+export declare namespace ToastProvider {
+    export type State = ToastProviderState;
+    export type Props = ToastProviderProps;
+}
+
+export declare interface ToastProviderProps {
+    children?: React_2.ReactNode;
+    /**
+     * The default amount of time (in ms) before a toast is auto dismissed.
+     * A value of `0` will prevent the toast from being dismissed automatically.
+     * @default 5000
+     */
+    timeout?: number | undefined;
+    /**
+     * The maximum number of toasts that can be displayed at once.
+     * When the limit is reached, the oldest toast will be removed to make room for the new one.
+     * @default 3
+     */
+    limit?: number | undefined;
+    /**
+     * A global manager for toasts to use outside of a React component.
+     */
+    toastManager?: ToastManager | undefined;
+}
+
+export declare interface ToastProviderState {}
+
+/**
+ * Groups all parts of an individual toast.
+ * Renders a `<div>` element.
+ *
+ * Documentation: [Base UI Toast](https://base-ui.com/react/components/toast)
+ */
+export declare const ToastRoot: React_2.ForwardRefExoticComponent<Omit<ToastRootProps, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare namespace ToastRoot {
+    export type ToastObject<Data extends object = any> = ToastRootToastObject<Data>;
+    export type State = ToastRootState;
+    export type Props = ToastRootProps;
+}
+
+export declare interface ToastRootProps extends BaseUIComponentProps<'div', ToastRootState> {
+    /**
+     * The toast to render.
+     */
+    toast: ToastRootToastObject<any>;
+    /**
+     * Direction(s) in which the toast can be swiped to dismiss.
+     * @default ['down', 'right']
+     */
+    swipeDirection?: 'up' | 'down' | 'left' | 'right' | ('up' | 'down' | 'left' | 'right')[] | undefined;
+}
+
+export declare interface ToastRootState {
+    /**
+     * The transition status of the component.
+     */
+    transitionStatus: TransitionStatus;
+    /**
+     * Whether the toasts in the viewport are expanded.
+     */
+    expanded: boolean;
+    /**
+     * Whether the toast was limited because the toast limit was exceeded.
+     */
+    limited: boolean;
+    /**
+     * The type of the toast.
+     */
+    type: string | undefined;
+    /**
+     * Whether the toast is being swiped.
+     */
+    swiping: boolean;
+    /**
+     * The direction the toast is being swiped.
+     */
+    swipeDirection: 'up' | 'down' | 'left' | 'right' | undefined;
+}
+
+export declare type ToastRootToastObject<Data extends object = any> = ToastObject<Data>;
+
+/**
+ * A title that labels the toast.
+ * Renders an `<h2>` element.
+ *
+ * Documentation: [Base UI Toast](https://base-ui.com/react/components/toast)
+ */
+export declare const ToastTitle: React_2.ForwardRefExoticComponent<Omit<ToastTitleProps, "ref"> & React_2.RefAttributes<HTMLHeadingElement>>;
+
+export declare namespace ToastTitle {
+    export type State = ToastTitleState;
+    export type Props = ToastTitleProps;
+}
+
+export declare interface ToastTitleProps extends BaseUIComponentProps<'h2', ToastTitleState> {}
+
+export declare interface ToastTitleState {
+    /**
+     * The type of the toast.
+     */
+    type: string | undefined;
+}
+
+export declare type ToastType = 'status' | 'success' | 'error' | 'preview';
+
+/**
+ * A container viewport for toasts.
+ * Renders a `<div>` element.
+ *
+ * Documentation: [Base UI Toast](https://base-ui.com/react/components/toast)
+ */
+export declare const ToastViewport: React_2.ForwardRefExoticComponent<Omit<ToastViewportProps, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare namespace ToastViewport {
+    export type State = ToastViewportState;
+    export type Props = ToastViewportProps;
+}
+
+export declare interface ToastViewportProps extends BaseUIComponentProps<'div', ToastViewportState> {}
+
+export declare interface ToastViewportState {
+    /**
+     * Whether toasts are expanded in the viewport.
+     */
+    expanded: boolean;
+}
+
+declare type TransitionStatus = 'starting' | 'ending' | 'idle' | undefined;
+
+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;
+}
+
+/**
+ * Returns the array of toasts and methods to manage them.
+ */
+export declare function useToastManager<Data extends object = any>(): UseToastManagerReturnValue<Data>;
+
+export declare interface UseToastManagerReturnValue<Data extends object = any> {
+    toasts: ToastObject<Data>[];
+    add: <T extends Data = Data>(options: ToastManagerAddOptions<T>) => string;
+    close: (toastId?: string) => void;
+    update: <T extends Data = Data>(toastId: string, options: ToastManagerUpdateOptions<T>) => void;
+    promise: <Value, T extends Data = Data>(promise: Promise<Value>, options: ToastManagerPromiseOptions<Value, T>) => Promise<Value>;
+}
+
+declare const Viewport: React_2.ForwardRefExoticComponent<Omit<Omit<Omit<ToastViewportProps_2, "ref"> & React_2.RefAttributes<HTMLDivElement>, "ref">, "className"> & {
+    className?: string;
+} & React_2.RefAttributes<HTMLDivElement>>;
+
+/**
+ * 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 { }