@primitiv-ui/react 0.1.37 → 0.1.39

package/dist/Popover/hooks/usePopoverRoot.js

@@ -0,0 +1,49 @@
+"use client";
+import { useCallback, useEffect, useId, useMemo, useRef, useState, } from "react";
+import { useControllableState } from "../../hooks/index.js";
+export function usePopoverRoot({ defaultOpen = false, open: controlledOpen, onOpenChange, }) {
+    const contentId = useId();
+    const triggerRef = useRef(null);
+    const [open, setOpenBase] = useControllableState(controlledOpen, defaultOpen, onOpenChange);
+    // Mirror `open` so setOpen can short-circuit repeat transitions within a
+    // single event without a re-render in between. Without this, internal
+    // paths that converge on the same close (e.g. a light-dismiss firing both
+    // a `toggle` event and a document click) would double-notify consumers.
+    const openRef = useRef(open);
+    useEffect(() => {
+        openRef.current = open;
+    });
+    const setOpen = useCallback((next) => {
+        if (openRef.current === next)
+            return;
+        openRef.current = next;
+        setOpenBase(next);
+    }, [setOpenBase]);
+    const [titleId, setTitleId] = useState(undefined);
+    const [descriptionId, setDescriptionId] = useState(undefined);
+    const registerTitle = useCallback((id) => {
+        setTitleId(id);
+    }, []);
+    const registerDescription = useCallback((id) => {
+        setDescriptionId(id);
+    }, []);
+    const contextValue = useMemo(() => ({
+        open,
+        setOpen,
+        triggerRef,
+        contentId,
+        titleId,
+        descriptionId,
+        registerTitle,
+        registerDescription,
+    }), [
+        open,
+        setOpen,
+        contentId,
+        titleId,
+        descriptionId,
+        registerTitle,
+        registerDescription,
+    ]);
+    return { contextValue };
+}

package/dist/Popover/hooks/usePopoverTrigger.d.ts

@@ -0,0 +1,297 @@
+import { MouseEventHandler } from "react";
+import { PopoverTriggerProps } from "../types.js";
+export declare function usePopoverTrigger({ ref, onClick, asChild, ...rest }: Omit<PopoverTriggerProps, "children">): {
+    triggerProps: {
+        style?: import("react").CSSProperties | undefined;
+        className?: string | undefined | undefined;
+        defaultChecked?: boolean | undefined | undefined;
+        defaultValue?: string | number | readonly string[] | undefined;
+        suppressContentEditableWarning?: boolean | undefined | undefined;
+        suppressHydrationWarning?: boolean | undefined | undefined;
+        accessKey?: string | undefined | undefined;
+        autoCapitalize?: "off" | "none" | "on" | "sentences" | "words" | "characters" | undefined | (string & {}) | undefined;
+        autoFocus?: boolean | undefined | undefined;
+        contentEditable?: "inherit" | (boolean | "false" | "true") | "plaintext-only" | undefined;
+        contextMenu?: string | undefined | undefined;
+        dir?: string | undefined | undefined;
+        draggable?: (boolean | "false" | "true") | undefined;
+        enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined | undefined;
+        hidden?: boolean | undefined | undefined;
+        id?: string | undefined | undefined;
+        lang?: string | undefined | undefined;
+        nonce?: string | undefined | undefined;
+        slot?: string | undefined | undefined;
+        spellCheck?: (boolean | "false" | "true") | undefined;
+        tabIndex?: number | undefined | undefined;
+        title?: string | undefined | undefined;
+        translate?: "yes" | "no" | undefined | undefined;
+        radioGroup?: string | undefined | undefined;
+        role?: import("react").AriaRole | undefined;
+        about?: string | undefined | undefined;
+        content?: string | undefined | undefined;
+        datatype?: string | undefined | undefined;
+        inlist?: any;
+        prefix?: string | undefined | undefined;
+        property?: string | undefined | undefined;
+        rel?: string | undefined | undefined;
+        resource?: string | undefined | undefined;
+        rev?: string | undefined | undefined;
+        typeof?: string | undefined | undefined;
+        vocab?: string | undefined | undefined;
+        autoCorrect?: string | undefined | undefined;
+        autoSave?: string | undefined | undefined;
+        color?: string | undefined | undefined;
+        itemProp?: string | undefined | undefined;
+        itemScope?: boolean | undefined | undefined;
+        itemType?: string | undefined | undefined;
+        itemID?: string | undefined | undefined;
+        itemRef?: string | undefined | undefined;
+        results?: number | undefined | undefined;
+        security?: string | undefined | undefined;
+        unselectable?: "on" | "off" | undefined | undefined;
+        popover?: "" | "auto" | "manual" | "hint" | undefined | undefined;
+        popoverTargetAction?: "toggle" | "show" | "hide" | undefined | undefined;
+        popoverTarget?: string | undefined | undefined;
+        inert?: boolean | undefined | undefined;
+        inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined | undefined;
+        is?: string | undefined | undefined;
+        exportparts?: string | undefined | undefined;
+        part?: string | undefined | undefined;
+        "aria-activedescendant"?: string | undefined | undefined;
+        "aria-atomic"?: (boolean | "false" | "true") | undefined;
+        "aria-autocomplete"?: "none" | "inline" | "list" | "both" | undefined | undefined;
+        "aria-braillelabel"?: string | undefined | undefined;
+        "aria-brailleroledescription"?: string | undefined | undefined;
+        "aria-busy"?: (boolean | "false" | "true") | undefined;
+        "aria-checked"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
+        "aria-colcount"?: number | undefined | undefined;
+        "aria-colindex"?: number | undefined | undefined;
+        "aria-colindextext"?: string | undefined | undefined;
+        "aria-colspan"?: number | undefined | undefined;
+        "aria-controls": string;
+        "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined | undefined;
+        "aria-describedby"?: string | undefined | undefined;
+        "aria-description"?: string | undefined | undefined;
+        "aria-details"?: string | undefined | undefined;
+        "aria-disabled"?: (boolean | "false" | "true") | undefined;
+        "aria-dropeffect"?: "none" | "copy" | "execute" | "link" | "move" | "popup" | undefined | undefined;
+        "aria-errormessage"?: string | undefined | undefined;
+        "aria-expanded": boolean | "false" | "true";
+        "aria-flowto"?: string | undefined | undefined;
+        "aria-grabbed"?: (boolean | "false" | "true") | undefined;
+        "aria-haspopup": boolean | "dialog" | "menu" | "listbox" | "grid" | "false" | "true" | "tree";
+        "aria-hidden"?: (boolean | "false" | "true") | undefined;
+        "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined | undefined;
+        "aria-keyshortcuts"?: string | undefined | undefined;
+        "aria-label"?: string | undefined | undefined;
+        "aria-labelledby"?: string | undefined | undefined;
+        "aria-level"?: number | undefined | undefined;
+        "aria-live"?: "off" | "assertive" | "polite" | undefined | undefined;
+        "aria-modal"?: (boolean | "false" | "true") | undefined;
+        "aria-multiline"?: (boolean | "false" | "true") | undefined;
+        "aria-multiselectable"?: (boolean | "false" | "true") | undefined;
+        "aria-orientation"?: "horizontal" | "vertical" | undefined | undefined;
+        "aria-owns"?: string | undefined | undefined;
+        "aria-placeholder"?: string | undefined | undefined;
+        "aria-posinset"?: number | undefined | undefined;
+        "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
+        "aria-readonly"?: (boolean | "false" | "true") | undefined;
+        "aria-relevant"?: "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text" | "text additions" | "text removals" | undefined | undefined;
+        "aria-required"?: (boolean | "false" | "true") | undefined;
+        "aria-roledescription"?: string | undefined | undefined;
+        "aria-rowcount"?: number | undefined | undefined;
+        "aria-rowindex"?: number | undefined | undefined;
+        "aria-rowindextext"?: string | undefined | undefined;
+        "aria-rowspan"?: number | undefined | undefined;
+        "aria-selected"?: (boolean | "false" | "true") | undefined;
+        "aria-setsize"?: number | undefined | undefined;
+        "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined | undefined;
+        "aria-valuemax"?: number | undefined | undefined;
+        "aria-valuemin"?: number | undefined | undefined;
+        "aria-valuenow"?: number | undefined | undefined;
+        "aria-valuetext"?: string | undefined | undefined;
+        dangerouslySetInnerHTML?: {
+            __html: string | TrustedHTML;
+        } | undefined | undefined;
+        onCopy?: import("react").ClipboardEventHandler<HTMLButtonElement> | undefined;
+        onCopyCapture?: import("react").ClipboardEventHandler<HTMLButtonElement> | undefined;
+        onCut?: import("react").ClipboardEventHandler<HTMLButtonElement> | undefined;
+        onCutCapture?: import("react").ClipboardEventHandler<HTMLButtonElement> | undefined;
+        onPaste?: import("react").ClipboardEventHandler<HTMLButtonElement> | undefined;
+        onPasteCapture?: import("react").ClipboardEventHandler<HTMLButtonElement> | undefined;
+        onCompositionEnd?: import("react").CompositionEventHandler<HTMLButtonElement> | undefined;
+        onCompositionEndCapture?: import("react").CompositionEventHandler<HTMLButtonElement> | undefined;
+        onCompositionStart?: import("react").CompositionEventHandler<HTMLButtonElement> | undefined;
+        onCompositionStartCapture?: import("react").CompositionEventHandler<HTMLButtonElement> | undefined;
+        onCompositionUpdate?: import("react").CompositionEventHandler<HTMLButtonElement> | undefined;
+        onCompositionUpdateCapture?: import("react").CompositionEventHandler<HTMLButtonElement> | undefined;
+        onFocus?: import("react").FocusEventHandler<HTMLButtonElement> | undefined;
+        onFocusCapture?: import("react").FocusEventHandler<HTMLButtonElement> | undefined;
+        onBlur?: import("react").FocusEventHandler<HTMLButtonElement> | undefined;
+        onBlurCapture?: import("react").FocusEventHandler<HTMLButtonElement> | undefined;
+        onChange?: import("react").ChangeEventHandler<HTMLButtonElement, Element> | undefined;
+        onChangeCapture?: import("react").ChangeEventHandler<HTMLButtonElement, Element> | undefined;
+        onBeforeInput?: import("react").InputEventHandler<HTMLButtonElement> | undefined;
+        onBeforeInputCapture?: import("react").InputEventHandler<HTMLButtonElement> | undefined;
+        onInput?: import("react").InputEventHandler<HTMLButtonElement> | undefined;
+        onInputCapture?: import("react").InputEventHandler<HTMLButtonElement> | undefined;
+        onReset?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onResetCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onSubmit?: import("react").SubmitEventHandler<HTMLButtonElement> | undefined;
+        onSubmitCapture?: import("react").SubmitEventHandler<HTMLButtonElement> | undefined;
+        onInvalid?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onInvalidCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onLoad?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onLoadCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onError?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onErrorCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onKeyDown?: import("react").KeyboardEventHandler<HTMLButtonElement> | undefined;
+        onKeyDownCapture?: import("react").KeyboardEventHandler<HTMLButtonElement> | undefined;
+        onKeyPress?: import("react").KeyboardEventHandler<HTMLButtonElement> | undefined;
+        onKeyPressCapture?: import("react").KeyboardEventHandler<HTMLButtonElement> | undefined;
+        onKeyUp?: import("react").KeyboardEventHandler<HTMLButtonElement> | undefined;
+        onKeyUpCapture?: import("react").KeyboardEventHandler<HTMLButtonElement> | undefined;
+        onAbort?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onAbortCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onCanPlay?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onCanPlayCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onCanPlayThrough?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onCanPlayThroughCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onDurationChange?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onDurationChangeCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onEmptied?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onEmptiedCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onEncrypted?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onEncryptedCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onEnded?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onEndedCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onLoadedData?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onLoadedDataCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onLoadedMetadata?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onLoadedMetadataCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onLoadStart?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onLoadStartCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onPause?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onPauseCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onPlay?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onPlayCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onPlaying?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onPlayingCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onProgress?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onProgressCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onRateChange?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onRateChangeCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onSeeked?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onSeekedCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onSeeking?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onSeekingCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onStalled?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onStalledCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onSuspend?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onSuspendCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onTimeUpdate?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onTimeUpdateCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onVolumeChange?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onVolumeChangeCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onWaiting?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onWaitingCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onAuxClick?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onAuxClickCapture?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onClickCapture?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onContextMenu?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onContextMenuCapture?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onDoubleClick?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onDoubleClickCapture?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onDrag?: import("react").DragEventHandler<HTMLButtonElement> | undefined;
+        onDragCapture?: import("react").DragEventHandler<HTMLButtonElement> | undefined;
+        onDragEnd?: import("react").DragEventHandler<HTMLButtonElement> | undefined;
+        onDragEndCapture?: import("react").DragEventHandler<HTMLButtonElement> | undefined;
+        onDragEnter?: import("react").DragEventHandler<HTMLButtonElement> | undefined;
+        onDragEnterCapture?: import("react").DragEventHandler<HTMLButtonElement> | undefined;
+        onDragExit?: import("react").DragEventHandler<HTMLButtonElement> | undefined;
+        onDragExitCapture?: import("react").DragEventHandler<HTMLButtonElement> | undefined;
+        onDragLeave?: import("react").DragEventHandler<HTMLButtonElement> | undefined;
+        onDragLeaveCapture?: import("react").DragEventHandler<HTMLButtonElement> | undefined;
+        onDragOver?: import("react").DragEventHandler<HTMLButtonElement> | undefined;
+        onDragOverCapture?: import("react").DragEventHandler<HTMLButtonElement> | undefined;
+        onDragStart?: import("react").DragEventHandler<HTMLButtonElement> | undefined;
+        onDragStartCapture?: import("react").DragEventHandler<HTMLButtonElement> | undefined;
+        onDrop?: import("react").DragEventHandler<HTMLButtonElement> | undefined;
+        onDropCapture?: import("react").DragEventHandler<HTMLButtonElement> | undefined;
+        onMouseDown?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onMouseDownCapture?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onMouseEnter?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onMouseLeave?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onMouseMove?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onMouseMoveCapture?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onMouseOut?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onMouseOutCapture?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onMouseOver?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onMouseOverCapture?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onMouseUp?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onMouseUpCapture?: MouseEventHandler<HTMLButtonElement> | undefined;
+        onSelect?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onSelectCapture?: import("react").ReactEventHandler<HTMLButtonElement> | undefined;
+        onTouchCancel?: import("react").TouchEventHandler<HTMLButtonElement> | undefined;
+        onTouchCancelCapture?: import("react").TouchEventHandler<HTMLButtonElement> | undefined;
+        onTouchEnd?: import("react").TouchEventHandler<HTMLButtonElement> | undefined;
+        onTouchEndCapture?: import("react").TouchEventHandler<HTMLButtonElement> | undefined;
+        onTouchMove?: import("react").TouchEventHandler<HTMLButtonElement> | undefined;
+        onTouchMoveCapture?: import("react").TouchEventHandler<HTMLButtonElement> | undefined;
+        onTouchStart?: import("react").TouchEventHandler<HTMLButtonElement> | undefined;
+        onTouchStartCapture?: import("react").TouchEventHandler<HTMLButtonElement> | undefined;
+        onPointerDown?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onPointerDownCapture?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onPointerMove?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onPointerMoveCapture?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onPointerUp?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onPointerUpCapture?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onPointerCancel?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onPointerCancelCapture?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onPointerEnter?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onPointerLeave?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onPointerOver?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onPointerOverCapture?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onPointerOut?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onPointerOutCapture?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onGotPointerCapture?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onGotPointerCaptureCapture?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onLostPointerCapture?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onLostPointerCaptureCapture?: import("react").PointerEventHandler<HTMLButtonElement> | undefined;
+        onScroll?: import("react").UIEventHandler<HTMLButtonElement> | undefined;
+        onScrollCapture?: import("react").UIEventHandler<HTMLButtonElement> | undefined;
+        onScrollEnd?: import("react").UIEventHandler<HTMLButtonElement> | undefined;
+        onScrollEndCapture?: import("react").UIEventHandler<HTMLButtonElement> | undefined;
+        onWheel?: import("react").WheelEventHandler<HTMLButtonElement> | undefined;
+        onWheelCapture?: import("react").WheelEventHandler<HTMLButtonElement> | undefined;
+        onAnimationStart?: import("react").AnimationEventHandler<HTMLButtonElement> | undefined;
+        onAnimationStartCapture?: import("react").AnimationEventHandler<HTMLButtonElement> | undefined;
+        onAnimationEnd?: import("react").AnimationEventHandler<HTMLButtonElement> | undefined;
+        onAnimationEndCapture?: import("react").AnimationEventHandler<HTMLButtonElement> | undefined;
+        onAnimationIteration?: import("react").AnimationEventHandler<HTMLButtonElement> | undefined;
+        onAnimationIterationCapture?: import("react").AnimationEventHandler<HTMLButtonElement> | undefined;
+        onToggle?: import("react").ToggleEventHandler<HTMLButtonElement> | undefined;
+        onBeforeToggle?: import("react").ToggleEventHandler<HTMLButtonElement> | undefined;
+        onTransitionCancel?: import("react").TransitionEventHandler<HTMLButtonElement> | undefined;
+        onTransitionCancelCapture?: import("react").TransitionEventHandler<HTMLButtonElement> | undefined;
+        onTransitionEnd?: import("react").TransitionEventHandler<HTMLButtonElement> | undefined;
+        onTransitionEndCapture?: import("react").TransitionEventHandler<HTMLButtonElement> | undefined;
+        onTransitionRun?: import("react").TransitionEventHandler<HTMLButtonElement> | undefined;
+        onTransitionRunCapture?: import("react").TransitionEventHandler<HTMLButtonElement> | undefined;
+        onTransitionStart?: import("react").TransitionEventHandler<HTMLButtonElement> | undefined;
+        onTransitionStartCapture?: import("react").TransitionEventHandler<HTMLButtonElement> | undefined;
+        form?: string | undefined | undefined;
+        key?: import("react").Key | null | undefined;
+        disabled?: boolean | undefined | undefined;
+        value?: string | number | readonly string[] | undefined;
+        formAction?: string | ((formData: FormData) => void | Promise<void>) | undefined;
+        formEncType?: string | undefined | undefined;
+        formMethod?: string | undefined | undefined;
+        formNoValidate?: boolean | undefined | undefined;
+        formTarget?: string | undefined | undefined;
+        name?: string | undefined | undefined;
+        type?: "submit" | "reset" | "button" | undefined | undefined;
+        ref: import("react").RefObject<HTMLButtonElement | null> | ((node: HTMLButtonElement) => void);
+        onClick: (event: import("react").MouseEvent<Element, MouseEvent>) => void;
+    };
+};

package/dist/Popover/hooks/usePopoverTrigger.js

@@ -0,0 +1,19 @@
+"use client";
+import { composeEventHandlers, composeRefs } from "../../Slot/index.js";
+import { usePopoverContext } from "../PopoverContext.js";
+export function usePopoverTrigger({ ref, onClick, asChild = false, ...rest }) {
+    const { open, setOpen, triggerRef, contentId } = usePopoverContext();
+    const composedRef = ref
+        ? composeRefs(triggerRef, ref)
+        : triggerRef;
+    const toggle = () => setOpen(!open);
+    const triggerProps = {
+        ref: composedRef,
+        "aria-haspopup": "dialog",
+        "aria-expanded": open,
+        "aria-controls": contentId,
+        onClick: composeEventHandlers(onClick, toggle),
+        ...rest,
+    };
+    return { triggerProps };
+}

package/dist/Popover/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./Popover.js";
+export * from "./types.js";

package/dist/Popover/index.js

@@ -0,0 +1,2 @@
+export * from "./Popover.js";
+export * from "./types.js";

package/dist/Popover/types.d.ts

@@ -0,0 +1,183 @@
+import { ComponentProps, ReactNode, Ref, RefObject } from "react";
+/** Props common to both controlled and uncontrolled `Popover.Root` modes. */
+export type PopoverRootBaseProps = {
+    /** The Popover sub-components — typically a {@link PopoverTriggerProps | `Popover.Trigger`}
+     * and a {@link PopoverContentProps | `Popover.Content`}, optionally a
+     * {@link PopoverAnchorProps | `Popover.Anchor`}. */
+    children?: ReactNode;
+};
+/**
+ * Props for {@link PopoverRoot | `Popover.Root`} in uncontrolled mode — the
+ * component owns the open state. Pass `defaultOpen` to set the initial value;
+ * `open` is forbidden.
+ */
+export type PopoverRootUncontrolledProps = PopoverRootBaseProps & {
+    /**
+     * Whether the popover is open on first render. The component owns the flag
+     * from then on (trigger toggles, `Popover.Close`, Escape, and light-dismiss
+     * all mutate it internally).
+     * @default false
+     */
+    defaultOpen?: boolean;
+    /** Forbidden in uncontrolled mode — use `defaultOpen` instead. */
+    open?: never;
+    /** Called with the new open state after every transition. Optional in
+     * uncontrolled mode; use it to observe (not drive) open/close. */
+    onOpenChange?: (open: boolean) => void;
+};
+/**
+ * Props for {@link PopoverRoot | `Popover.Root`} in controlled mode — the
+ * parent owns the open value. Pass `open` and `onOpenChange` together;
+ * `defaultOpen` is forbidden.
+ */
+export type PopoverRootControlledProps = PopoverRootBaseProps & {
+    /** The current open state. Must be kept in sync by the parent via
+     * `onOpenChange`. */
+    open: boolean;
+    /** Called with the requested open state whenever the popover wants to open
+     * or close (trigger click, `Popover.Close`, Escape, outside dismiss).
+     * Required in controlled mode — the popover will not move unless the parent
+     * updates `open`. */
+    onOpenChange: (open: boolean) => void;
+    /** Forbidden in controlled mode — use `open` instead. */
+    defaultOpen?: never;
+};
+/**
+ * Props for {@link PopoverRoot | `Popover.Root`} — a discriminated union that
+ * resolves to either {@link PopoverRootUncontrolledProps} or
+ * {@link PopoverRootControlledProps}, so TypeScript accepts exactly one mode.
+ */
+export type PopoverRootProps = PopoverRootUncontrolledProps | PopoverRootControlledProps;
+/**
+ * Props for {@link PopoverTrigger | `Popover.Trigger`}, the button that toggles
+ * the popover. Extends the native `<button>` attributes (with `ref` re-typed to
+ * the generic element `T`); the trigger's `aria-haspopup` / `aria-expanded` /
+ * `aria-controls` and toggle `onClick` are added by the component (a consumer
+ * `onClick` composes and can `preventDefault()` to veto the toggle).
+ */
+export type PopoverTriggerProps<T extends HTMLElement = HTMLButtonElement> = Omit<ComponentProps<"button">, "ref"> & {
+    /** Trigger content (label, icon, etc.). */
+    children?: ReactNode;
+    /**
+     * Render the single child element instead of the default `<button>`,
+     * merging the trigger's ARIA, composed event handlers, and ref onto it via
+     * the {@link Slot} pattern.
+     * @default false
+     */
+    asChild?: boolean;
+    /** Ref to the rendered element, composed with Root's internal trigger ref
+     * (used for focus return on close). Defaults to `HTMLButtonElement`; with
+     * `asChild`, set the generic to the child's element type
+     * (e.g. `HTMLAnchorElement`). */
+    ref?: Ref<T>;
+};
+/**
+ * Props for {@link PopoverContent | `Popover.Content`}, the floating panel.
+ * Extends the native `<div>` attributes; the component adds `role="dialog"`,
+ * `popover="auto"`, `tabIndex={-1}`, the `aria-labelledby` / `aria-describedby`
+ * wiring (from {@link PopoverTitleProps | `Popover.Title`} /
+ * {@link PopoverDescriptionProps | `Popover.Description`}), and the
+ * `data-state` hook. Open/close, focus movement into the panel, Escape, and
+ * light-dismiss are all handled internally — no props needed.
+ */
+export type PopoverContentProps = ComponentProps<"div"> & {
+    /** Panel content — typically {@link PopoverTitleProps | `Popover.Title`},
+     * body markup, and a {@link PopoverCloseProps | `Popover.Close`}. */
+    children?: ReactNode;
+    /**
+     * Render the single child element (e.g. a `<section>` or motion wrapper)
+     * instead of the default `<div>`, merging the dialog props and internal ref
+     * onto it via the {@link Slot} pattern.
+     * @default false
+     */
+    asChild?: boolean;
+    /** Ref to the rendered element, composed with Root's internal content ref so
+     * open/close and focus management keep working. */
+    ref?: Ref<HTMLDivElement>;
+};
+/**
+ * Props for {@link PopoverAnchor | `Popover.Anchor`}, an optional element the
+ * popover is positioned against instead of the trigger. Attach a CSS
+ * `anchor-name` to it and a matching `position-anchor` to
+ * {@link PopoverContentProps | `Popover.Content`}. Renders no behaviour of its
+ * own — positioning is purely a CSS concern.
+ */
+export type PopoverAnchorProps = ComponentProps<"div"> & {
+    /** Anchor content — the element(s) the popover should be positioned against. */
+    children?: ReactNode;
+    /**
+     * Render the single child element instead of the default `<div>`, projecting
+     * the anchor onto an existing element via the {@link Slot} pattern.
+     * @default false
+     */
+    asChild?: boolean;
+};
+/**
+ * Props for {@link PopoverClose | `Popover.Close`}, the button that closes the
+ * popover and returns focus to the trigger. Extends the native `<button>`
+ * attributes; a consumer `onClick` composes with the close (runs first, can
+ * `preventDefault()` to veto closing).
+ */
+export type PopoverCloseProps = ComponentProps<"button"> & {
+    /** Close-button content (label, icon, etc.). */
+    children?: ReactNode;
+    /**
+     * Render the single child element (e.g. a text link or icon button) instead
+     * of the default `<button>`, merging the close behaviour onto it via the
+     * {@link Slot} pattern.
+     * @default false
+     */
+    asChild?: boolean;
+};
+/**
+ * Props for {@link PopoverTitle | `Popover.Title`}, the popover's accessible
+ * name. Extends the native `<h2>` attributes; the component supplies a
+ * generated `id` and registers it so `Popover.Content` exposes it via
+ * `aria-labelledby`.
+ */
+export type PopoverTitleProps = ComponentProps<"h2"> & {
+    /** Title content, rendered as the popover's accessible name. */
+    children?: ReactNode;
+    /**
+     * Render the single child element (e.g. an `<h3>`) instead of the default
+     * `<h2>` via the {@link Slot} pattern; the generated `id` is still applied
+     * and registered.
+     * @default false
+     */
+    asChild?: boolean;
+};
+/**
+ * Props for {@link PopoverDescription | `Popover.Description`}, the popover's
+ * accessible description. Extends the native `<p>` attributes; the component
+ * supplies a generated `id` and registers it so `Popover.Content` exposes it
+ * via `aria-describedby`.
+ */
+export type PopoverDescriptionProps = ComponentProps<"p"> & {
+    /** Description content, exposed as the popover's accessible description. */
+    children?: ReactNode;
+    /**
+     * Render the single child element instead of the default `<p>` via the
+     * {@link Slot} pattern; the generated `id` is still applied and registered.
+     * @default false
+     */
+    asChild?: boolean;
+};
+/** Value shared through Popover context to all sub-components. */
+export type PopoverContextValue = {
+    /** Whether the popover is currently open. */
+    open: boolean;
+    /** Request an open-state change. */
+    setOpen: (open: boolean) => void;
+    /** Ref to the trigger element, used for focus return. */
+    triggerRef: RefObject<HTMLButtonElement | null>;
+    /** Generated id of the content panel. */
+    contentId: string;
+    /** Id of the rendered `Popover.Title`, or `undefined` when absent. */
+    titleId: string | undefined;
+    /** Id of the rendered `Popover.Description`, or `undefined` when absent. */
+    descriptionId: string | undefined;
+    /** Register (or clear) the title id for `aria-labelledby`. */
+    registerTitle: (id: string | undefined) => void;
+    /** Register (or clear) the description id for `aria-describedby`. */
+    registerDescription: (id: string | undefined) => void;
+};

package/dist/Popover/types.js

@@ -0,0 +1 @@
+export {};

package/dist/Portal/Portal.d.ts

@@ -0,0 +1,70 @@
+import { type ReactPortal } from "react";
+import type { PortalProps } from "./types.js";
+/**
+ * Teleports its children into a DOM node outside the current React subtree
+ * using React's `createPortal`. Renders no host element of its own — the
+ * children appear directly inside the target `container`.
+ *
+ * Use `Portal` whenever a subtree must escape its ancestor's stacking context,
+ * overflow clipping, or z-index hierarchy — tooltips, modals, dropdowns, and
+ * similar overlays are the typical cases. `Portal` carries no state, context,
+ * or open/close awareness; those concerns belong in the composing component
+ * (see `Modal.Portal`, which layers open-state suppression and `forceMount` on
+ * top of this primitive).
+ *
+ * **Conditional rendering.** `Portal` always mounts when rendered. To control
+ * visibility, conditionally render the `Portal` itself, or manage show/hide
+ * logic in the composing component:
+ *
+ * ```tsx
+ * {isOpen && (
+ *   <Portal>
+ *     <div role="dialog">...</div>
+ *   </Portal>
+ * )}
+ * ```
+ *
+ * For CSS-driven exit animations, keep the portal mounted and drive styles
+ * through a `data-state` attribute on its child:
+ *
+ * ```tsx
+ * <Portal>
+ *   <div data-state={isOpen ? "open" : "closed"}>...</div>
+ * </Portal>
+ * ```
+ *
+ * **Server rendering.** There is no `document` on the server, so `Portal`
+ * renders nothing there — and, to match the server HTML, during hydration too —
+ * then portals its children once mounted in the browser. That matters for a
+ * force-mounted overlay (`Modal.Portal` / `Drawer.Portal` with `forceMount`),
+ * which renders its `Portal` while closed and so reaches it on the server.
+ *
+ * **Ref forwarding.** `Portal` does not forward a ref (there is no host
+ * element to attach one to). Attach `ref` directly to the child element
+ * rendered inside the portal.
+ *
+ * @example Mount into document.body (default)
+ * ```tsx
+ * import { Portal } from "@primitiv-ui/react";
+ *
+ * <Portal>
+ *   <div role="dialog" aria-modal="true">
+ *     Modal content rendered directly in document.body
+ *   </div>
+ * </Portal>
+ * ```
+ *
+ * @example Mount into a custom container
+ * ```tsx
+ * const overlayRoot = document.getElementById("overlay-root");
+ *
+ * <Portal container={overlayRoot}>
+ *   <div role="tooltip">Tooltip content</div>
+ * </Portal>
+ * ```
+ */
+declare function Portal({ children, container }: PortalProps): ReactPortal | null;
+declare namespace Portal {
+    var displayName: string;
+}
+export { Portal };