@skdx/react 0.27.0 → 0.29.0

package/dist/popover/types.d.cts

@@ -1,111 +1,261 @@
 import type * as React from 'react';
-import type { PopperContentProps } from '../utils/popper.cjs';
+import type { AutoFocusEvent } from '../utils/dismissal.cjs';
+import type { PassThroughProps } from '../utils/passThrough.cjs';
+import type { Align, PopperContentProps, Side } from '../utils/popper.cjs';
 import type { PortalProps } from '../utils/portal.cjs';
 import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
 import type { FocusOutsideEvent, InteractOutsideEvent } from '../utils/useDismiss.cjs';
-import type { AutoFocusEvent } from '../utils/useFocusTrap.cjs';
+/** What the panel is: an operable `role="dialog"`, or an inert `role="tooltip"` bubble. */
+export type PopoverRole = 'dialog' | 'tooltip';
+/** Which gesture reveals the panel: a click on the trigger, or the pointer entering it. */
+export type PopoverOpenOn = 'click' | 'hover';
+/** The panel's `data-state`: a tooltip bubble reports whether it paid its open delay or skipped it. */
+export type PopoverState = 'closed' | 'open' | 'delayed-open' | 'instant-open';
+/** @internal Timing shared by every `role="tooltip"` popover under one {@link PopoverProvider}. */
+export interface PopoverProviderContextValue {
+    delayDuration: number;
+    skipDelayDuration: number;
+    closeDelay: number;
+    disableHoverableContent: boolean;
+    /** False during the skip window that follows a close, when a sibling bubble opens at once. */
+    isOpenDelayedRef: React.RefObject<boolean>;
+    onOpen: () => void;
+    onClose: () => void;
+}
+/** Props for {@link PopoverProvider}, which coordinates hover-delay timing across the tooltips beneath it. */
+export interface PopoverProviderProps {
+    /**
+     * The subtree whose `role="tooltip"` popovers share this timing.
+     * @default undefined — renders nothing if omitted.
+     */
+    children?: React.ReactNode | undefined;
+    /**
+     * Delay in milliseconds before a descendant tooltip opens on hover; each may override it with its own `openDelay`.
+     * @default 700
+     */
+    delayDuration?: number | undefined;
+    /**
+     * Window in milliseconds after a tooltip closes during which sibling tooltips open instantly, so sweeping a row of triggers pays the delay once.
+     * @default 300
+     */
+    skipDelayDuration?: number | undefined;
+    /**
+     * Delay in milliseconds before a descendant tooltip closes once the pointer has left its trigger; a hoverable bubble still applies the 150ms floor.
+     * @default 0
+     */
+    closeDelay?: number | undefined;
+    /**
+     * Whether descendant bubbles ignore the pointer entirely, so moving off the trigger closes them; each may override it.
+     * @default false
+     */
+    disableHoverableContent?: boolean | undefined;
+}
 /** @internal Shared state distributed from {@link Popover} to its parts via context. Not part of the public API. */
 export interface PopoverContextValue {
-    triggerRef: React.RefObject<HTMLButtonElement | null>;
+    triggerRef: React.RefObject<HTMLElement | null>;
     contentRef: React.RefObject<HTMLDivElement | null>;
     contentId: string;
+    titleId: string;
+    descriptionId: string;
+    /** Whether a {@link PopoverTitle} is mounted, so Content can withhold a dangling `aria-labelledby`. */
+    hasTitle: boolean;
+    setHasTitle: (present: boolean) => void;
+    /** Whether a {@link PopoverDescription} is mounted, gating `aria-describedby` the same way. */
+    hasDescription: boolean;
+    setHasDescription: (present: boolean) => void;
     open: boolean;
     onOpenChange: (open: boolean) => void;
-    modal: boolean;
+    modal: PopoverModality;
+    /** What the panel is; `tooltip` makes it an inert bubble the trigger points `aria-describedby` at. */
+    role: PopoverRole;
+    /** Which gesture reveals the panel; `hover` arms the delay handlers below. */
+    openOn: PopoverOpenOn;
+    /** The panel's `data-state` value, which a tooltip splits into delayed-open and instant-open. */
+    state: PopoverState;
+    /** Whether the pointer may travel from the trigger onto the panel and keep it open. */
+    hoverable: boolean;
+    /** Opens at once — focus of the trigger, and the pointer arriving on the panel itself. */
+    onOpen: () => void;
+    /** Opens after the resolved open delay, unless a Provider's skip window waives it. */
+    onDelayedOpen: () => void;
+    /** Closes at once — blur, click, Escape. */
+    onClose: () => void;
+    /** Closes after the resolved close delay, floored while the panel is hoverable. */
+    onDelayedClose: () => void;
+    /** Recomputes the panel's position immediately; a no-op while the panel is closed or unmounted. */
+    reposition: () => void;
 }
-/** Props for the {@link Popover} root. */
-export interface PopoverProps {
+/**
+ * How much of the page a popover contains: `'none'` nothing, `'trap-focus'` focus and outside interaction, `'modal'` adds the scroll lock too.
+ */
+export type PopoverModality = 'none' | 'modal' | 'trap-focus';
+/** Props for the {@link Popover} root; standard attributes ({@link PassThroughProps}) land on the derived `PopoverContent` panel. */
+export interface PopoverProps extends PassThroughProps {
     /**
-     * The trigger, portal, and content parts, distributed open state via context.
+     * Plain body content, or a hand-composed `PopoverTrigger`/`PopoverPortal` tree that replaces the derived anatomy.
      * @default undefined
      */
-    children?: React.ReactNode;
+    children?: React.ReactNode | undefined;
+    /**
+     * The trigger element for the derived anatomy, decorated with the popover's open/close behaviour via `asChild`.
+     * @default undefined — no derived trigger renders.
+     */
+    trigger?: React.ReactElement | undefined;
+    /**
+     * The derived panel's title, rendered as a `PopoverTitle` when `children` is plain body content.
+     * @default undefined — no derived title.
+     */
+    title?: string | undefined;
+    /**
+     * The derived panel's description, rendered as a `PopoverDescription` when `children` is plain body content.
+     * @default undefined — no derived description.
+     */
+    description?: string | undefined;
+    /**
+     * Which side of the trigger the derived panel opens on, read only when `children` is plain body content.
+     * @default 'bottom'
+     */
+    side?: Side | undefined;
+    /**
+     * Alignment of the derived panel along `side`, read only when `children` is plain body content.
+     * @default 'center'
+     */
+    align?: Align | undefined;
+    /**
+     * Whether the derived panel renders a `PopoverArrow` pointing back at the trigger.
+     * @default false
+     */
+    showArrow?: boolean | undefined;
     /**
      * Whether the popover is open, for controlled usage. Pair with `onOpenChange`.
      * @default undefined — uncontrolled, tracks its own open state internally.
      */
-    open?: boolean;
+    open?: boolean | undefined;
     /**
      * Whether the popover is initially open, for uncontrolled usage.
      * @default false
      */
-    defaultOpen?: boolean;
+    defaultOpen?: boolean | undefined;
     /**
      * Fires with the new open state whenever the popover opens or closes, controlled or not.
      * @default undefined — no-op if omitted.
      */
-    onOpenChange?: (open: boolean) => void;
+    onOpenChange?: ((open: boolean) => void) | undefined;
     /**
-     * Fires with the new open state once the change has finished on screen —
-     * after `PopoverContent`'s enter or exit animation ends, or as soon as it has
-     * settled when the panel declares no animation. Use it for work that must not race
-     * the transition; use `onOpenChange` for work that must not wait for it.
+     * Fires with the new open state once the change has finished on screen, after any enter/exit animation ends.
      * @default undefined — no-op if omitted.
      */
-    onOpenChangeComplete?: (open: boolean) => void;
+    onOpenChangeComplete?: ((open: boolean) => void) | undefined;
+    /**
+     * How much of the page the open popover takes over: see {@link PopoverModality}. Forced to `'none'` under `role="tooltip"`, which has no focus to contain.
+     * @default 'none'
+     */
+    modal?: PopoverModality | undefined;
+    /**
+     * Which gesture reveals the panel: `click` toggles it from the trigger, `hover` opens it on pointer enter after `openDelay` and closes it after `closeDelay`.
+     * @default 'click'
+     */
+    openOn?: PopoverOpenOn | undefined;
+    /**
+     * What the panel is: an operable `dialog`, or an inert `tooltip` bubble the trigger points `aria-describedby` at.
+     * @default 'dialog'
+     */
+    role?: PopoverRole | undefined;
+    /**
+     * Delay in milliseconds before a hover popover opens on pointer enter; under `role="tooltip"` an ancestor `PopoverProvider`'s `delayDuration` applies unless this is set.
+     * @default 700
+     */
+    openDelay?: number | undefined;
+    /**
+     * Delay in milliseconds before a hover popover closes once the pointer has left trigger and panel; a hoverable panel floors it at 150ms.
+     * @default 300
+     */
+    closeDelay?: number | undefined;
+    /**
+     * Whether the pointer moving from the trigger onto the panel closes it instead of keeping it open.
+     * @default false
+     */
+    disableHoverableContent?: boolean | undefined;
     /**
-     * Whether `PopoverContent` traps focus while open. Non-modal (the default)
-     * lets the rest of the page stay interactive.
+     * Whether the panel is suppressed: it never opens, never describes the trigger, and never fires `onOpenChange`.
      * @default false
      */
-    modal?: boolean;
+    disabled?: boolean | undefined;
 }
-/** Props for {@link PopoverTrigger}, the button that opens the popover and anchors its position. */
+/** Props for {@link PopoverTrigger}, the button that opens the popover and anchors its position; use `asChild` with an `<a href>` for a hover popover's link trigger. */
 export interface PopoverTriggerProps extends PrimitivePropsWithRef<'button'> {
 }
 /** Props for {@link PopoverPortal}, which teleports its children to `document.body`. */
 export interface PopoverPortalProps extends PortalProps {
     /**
-     * Render the portal even while the popover is closed, instead of
-     * unmounting it. Useful for animation libraries that need the outgoing
-     * content present in the DOM during an exit transition.
+     * Render the portal even while the popover is closed, instead of unmounting it.
      * @default false
      */
-    forceMount?: boolean;
+    forceMount?: boolean | undefined;
 }
-/**
- * Props for {@link PopoverContent}, the floating panel. Extends the shared
- * popper positioning props (`side`, `align`, `sideOffset`, `alignOffset`,
- * `avoidCollisions`, `collisionPadding`, `collisionBoundary`).
- */
+/** Props for {@link PopoverContent}, the floating panel, extending the shared popper positioning props. */
 export interface PopoverContentProps extends PopperContentProps {
     /**
-     * Keep this panel mounted even while the popover is closed. Useful for
-     * animation libraries that need the outgoing panel present in the DOM
-     * during an exit transition.
+     * Keep this panel mounted even while the popover is closed.
+     * @default false
+     */
+    forceMount?: boolean | undefined;
+    /**
+     * Clearance in pixels between the arrow and each end of the panel's edge, keeping it off rounded corners.
+     * @default 8
+     */
+    arrowPadding?: number | undefined;
+    /**
+     * Hide the panel (`visibility: hidden`) once its anchor scrolls fully out of view inside a clipping ancestor.
      * @default false
      */
-    forceMount?: boolean;
+    hideWhenDetached?: boolean | undefined;
+    /**
+     * CSS selector, resolved inside `PopoverContent`, for the element to focus when a focus-containing popover opens.
+     * @default undefined — the panel's first tabbable element, then the panel itself.
+     */
+    initialFocus?: string | undefined;
+    /**
+     * CSS selector for the element to focus when the popover closes, resolved at the document level.
+     * @default undefined — the trigger, or whatever was focused before opening.
+     */
+    finalFocus?: string | undefined;
     /**
      * Fires when Escape is pressed while the popover is open. Call `event.preventDefault()` to stop it from closing.
      * @default undefined — no-op if omitted.
      */
-    onEscapeKeyDown?: (event: KeyboardEvent) => void;
+    onEscapeKeyDown?: ((event: KeyboardEvent) => void) | undefined;
     /**
      * Fires on pointer-down outside the content. Call `event.preventDefault()` to stop the popover from closing.
      * @default undefined — no-op if omitted.
      */
-    onPointerDownOutside?: (event: PointerEvent) => void;
+    onPointerDownOutside?: ((event: PointerEvent) => void) | undefined;
     /**
-     * Fires when focus moves to an element outside the content. Call `event.preventDefault()` to stop the popover from closing. Receives a cancelable stand-in carrying the original `focusin` as its `detail`, since `focusin` itself cannot be canceled.
+     * Fires when focus moves outside the content, as a cancelable stand-in for the native `focusin`; call `event.preventDefault()` to stop it from closing.
      * @default undefined — no-op if omitted.
      */
-    onFocusOutside?: (event: FocusOutsideEvent) => void;
+    onFocusOutside?: ((event: FocusOutsideEvent) => void) | undefined;
     /**
-     * Fires for either kind of outside interaction — pointer-down or focus — immediately before the specific handler above and with the same event, so one `event.preventDefault()` here vetoes the dismissal whichever way it was triggered.
+     * Fires for either outside interaction — pointer-down or focus — before the specific handler, so one `event.preventDefault()` here vetoes either.
      * @default undefined — no-op if omitted.
      */
-    onInteractOutside?: (event: InteractOutsideEvent) => void;
+    onInteractOutside?: ((event: InteractOutsideEvent) => void) | undefined;
     /**
-     * Fires before focus moves into the content on open. Call `event.preventDefault()` to keep focus where it is and place it yourself. Modal popovers only — a non-modal popover never moves focus in.
+     * Fires before focus moves into the content on open, modal popovers only; call `event.preventDefault()` to place focus yourself.
      * @default undefined — focus moves to the first tabbable element.
      */
-    onOpenAutoFocus?: (event: AutoFocusEvent) => void;
+    onOpenAutoFocus?: ((event: AutoFocusEvent) => void) | undefined;
     /**
      * Fires before focus returns to the trigger (or, when `modal`, to whatever was focused before the popover opened). Call `event.preventDefault()` to suppress the return.
      * @default undefined — focus returns to the trigger.
      */
-    onCloseAutoFocus?: (event: AutoFocusEvent) => void;
+    onCloseAutoFocus?: ((event: AutoFocusEvent) => void) | undefined;
+}
+/** Props for {@link PopoverTitle}, the popover's accessible name. */
+export interface PopoverTitleProps extends PrimitivePropsWithRef<'h2'> {
+}
+/** Props for {@link PopoverDescription}, the popover's accessible description. */
+export interface PopoverDescriptionProps extends PrimitivePropsWithRef<'p'> {
 }
 /** Props for {@link PopoverClose}, a button that closes the popover. */
 export interface PopoverCloseProps extends PrimitivePropsWithRef<'button'> {

package/dist/popover/types.d.ts

@@ -1,111 +1,261 @@
 import type * as React from 'react';
-import type { PopperContentProps } from '../utils/popper.js';
+import type { AutoFocusEvent } from '../utils/dismissal.js';
+import type { PassThroughProps } from '../utils/passThrough.js';
+import type { Align, PopperContentProps, Side } from '../utils/popper.js';
 import type { PortalProps } from '../utils/portal.js';
 import type { PrimitivePropsWithRef } from '../utils/primitive.js';
 import type { FocusOutsideEvent, InteractOutsideEvent } from '../utils/useDismiss.js';
-import type { AutoFocusEvent } from '../utils/useFocusTrap.js';
+/** What the panel is: an operable `role="dialog"`, or an inert `role="tooltip"` bubble. */
+export type PopoverRole = 'dialog' | 'tooltip';
+/** Which gesture reveals the panel: a click on the trigger, or the pointer entering it. */
+export type PopoverOpenOn = 'click' | 'hover';
+/** The panel's `data-state`: a tooltip bubble reports whether it paid its open delay or skipped it. */
+export type PopoverState = 'closed' | 'open' | 'delayed-open' | 'instant-open';
+/** @internal Timing shared by every `role="tooltip"` popover under one {@link PopoverProvider}. */
+export interface PopoverProviderContextValue {
+    delayDuration: number;
+    skipDelayDuration: number;
+    closeDelay: number;
+    disableHoverableContent: boolean;
+    /** False during the skip window that follows a close, when a sibling bubble opens at once. */
+    isOpenDelayedRef: React.RefObject<boolean>;
+    onOpen: () => void;
+    onClose: () => void;
+}
+/** Props for {@link PopoverProvider}, which coordinates hover-delay timing across the tooltips beneath it. */
+export interface PopoverProviderProps {
+    /**
+     * The subtree whose `role="tooltip"` popovers share this timing.
+     * @default undefined — renders nothing if omitted.
+     */
+    children?: React.ReactNode | undefined;
+    /**
+     * Delay in milliseconds before a descendant tooltip opens on hover; each may override it with its own `openDelay`.
+     * @default 700
+     */
+    delayDuration?: number | undefined;
+    /**
+     * Window in milliseconds after a tooltip closes during which sibling tooltips open instantly, so sweeping a row of triggers pays the delay once.
+     * @default 300
+     */
+    skipDelayDuration?: number | undefined;
+    /**
+     * Delay in milliseconds before a descendant tooltip closes once the pointer has left its trigger; a hoverable bubble still applies the 150ms floor.
+     * @default 0
+     */
+    closeDelay?: number | undefined;
+    /**
+     * Whether descendant bubbles ignore the pointer entirely, so moving off the trigger closes them; each may override it.
+     * @default false
+     */
+    disableHoverableContent?: boolean | undefined;
+}
 /** @internal Shared state distributed from {@link Popover} to its parts via context. Not part of the public API. */
 export interface PopoverContextValue {
-    triggerRef: React.RefObject<HTMLButtonElement | null>;
+    triggerRef: React.RefObject<HTMLElement | null>;
     contentRef: React.RefObject<HTMLDivElement | null>;
     contentId: string;
+    titleId: string;
+    descriptionId: string;
+    /** Whether a {@link PopoverTitle} is mounted, so Content can withhold a dangling `aria-labelledby`. */
+    hasTitle: boolean;
+    setHasTitle: (present: boolean) => void;
+    /** Whether a {@link PopoverDescription} is mounted, gating `aria-describedby` the same way. */
+    hasDescription: boolean;
+    setHasDescription: (present: boolean) => void;
     open: boolean;
     onOpenChange: (open: boolean) => void;
-    modal: boolean;
+    modal: PopoverModality;
+    /** What the panel is; `tooltip` makes it an inert bubble the trigger points `aria-describedby` at. */
+    role: PopoverRole;
+    /** Which gesture reveals the panel; `hover` arms the delay handlers below. */
+    openOn: PopoverOpenOn;
+    /** The panel's `data-state` value, which a tooltip splits into delayed-open and instant-open. */
+    state: PopoverState;
+    /** Whether the pointer may travel from the trigger onto the panel and keep it open. */
+    hoverable: boolean;
+    /** Opens at once — focus of the trigger, and the pointer arriving on the panel itself. */
+    onOpen: () => void;
+    /** Opens after the resolved open delay, unless a Provider's skip window waives it. */
+    onDelayedOpen: () => void;
+    /** Closes at once — blur, click, Escape. */
+    onClose: () => void;
+    /** Closes after the resolved close delay, floored while the panel is hoverable. */
+    onDelayedClose: () => void;
+    /** Recomputes the panel's position immediately; a no-op while the panel is closed or unmounted. */
+    reposition: () => void;
 }
-/** Props for the {@link Popover} root. */
-export interface PopoverProps {
+/**
+ * How much of the page a popover contains: `'none'` nothing, `'trap-focus'` focus and outside interaction, `'modal'` adds the scroll lock too.
+ */
+export type PopoverModality = 'none' | 'modal' | 'trap-focus';
+/** Props for the {@link Popover} root; standard attributes ({@link PassThroughProps}) land on the derived `PopoverContent` panel. */
+export interface PopoverProps extends PassThroughProps {
     /**
-     * The trigger, portal, and content parts, distributed open state via context.
+     * Plain body content, or a hand-composed `PopoverTrigger`/`PopoverPortal` tree that replaces the derived anatomy.
      * @default undefined
      */
-    children?: React.ReactNode;
+    children?: React.ReactNode | undefined;
+    /**
+     * The trigger element for the derived anatomy, decorated with the popover's open/close behaviour via `asChild`.
+     * @default undefined — no derived trigger renders.
+     */
+    trigger?: React.ReactElement | undefined;
+    /**
+     * The derived panel's title, rendered as a `PopoverTitle` when `children` is plain body content.
+     * @default undefined — no derived title.
+     */
+    title?: string | undefined;
+    /**
+     * The derived panel's description, rendered as a `PopoverDescription` when `children` is plain body content.
+     * @default undefined — no derived description.
+     */
+    description?: string | undefined;
+    /**
+     * Which side of the trigger the derived panel opens on, read only when `children` is plain body content.
+     * @default 'bottom'
+     */
+    side?: Side | undefined;
+    /**
+     * Alignment of the derived panel along `side`, read only when `children` is plain body content.
+     * @default 'center'
+     */
+    align?: Align | undefined;
+    /**
+     * Whether the derived panel renders a `PopoverArrow` pointing back at the trigger.
+     * @default false
+     */
+    showArrow?: boolean | undefined;
     /**
      * Whether the popover is open, for controlled usage. Pair with `onOpenChange`.
      * @default undefined — uncontrolled, tracks its own open state internally.
      */
-    open?: boolean;
+    open?: boolean | undefined;
     /**
      * Whether the popover is initially open, for uncontrolled usage.
      * @default false
      */
-    defaultOpen?: boolean;
+    defaultOpen?: boolean | undefined;
     /**
      * Fires with the new open state whenever the popover opens or closes, controlled or not.
      * @default undefined — no-op if omitted.
      */
-    onOpenChange?: (open: boolean) => void;
+    onOpenChange?: ((open: boolean) => void) | undefined;
     /**
-     * Fires with the new open state once the change has finished on screen —
-     * after `PopoverContent`'s enter or exit animation ends, or as soon as it has
-     * settled when the panel declares no animation. Use it for work that must not race
-     * the transition; use `onOpenChange` for work that must not wait for it.
+     * Fires with the new open state once the change has finished on screen, after any enter/exit animation ends.
      * @default undefined — no-op if omitted.
      */
-    onOpenChangeComplete?: (open: boolean) => void;
+    onOpenChangeComplete?: ((open: boolean) => void) | undefined;
+    /**
+     * How much of the page the open popover takes over: see {@link PopoverModality}. Forced to `'none'` under `role="tooltip"`, which has no focus to contain.
+     * @default 'none'
+     */
+    modal?: PopoverModality | undefined;
+    /**
+     * Which gesture reveals the panel: `click` toggles it from the trigger, `hover` opens it on pointer enter after `openDelay` and closes it after `closeDelay`.
+     * @default 'click'
+     */
+    openOn?: PopoverOpenOn | undefined;
+    /**
+     * What the panel is: an operable `dialog`, or an inert `tooltip` bubble the trigger points `aria-describedby` at.
+     * @default 'dialog'
+     */
+    role?: PopoverRole | undefined;
+    /**
+     * Delay in milliseconds before a hover popover opens on pointer enter; under `role="tooltip"` an ancestor `PopoverProvider`'s `delayDuration` applies unless this is set.
+     * @default 700
+     */
+    openDelay?: number | undefined;
+    /**
+     * Delay in milliseconds before a hover popover closes once the pointer has left trigger and panel; a hoverable panel floors it at 150ms.
+     * @default 300
+     */
+    closeDelay?: number | undefined;
+    /**
+     * Whether the pointer moving from the trigger onto the panel closes it instead of keeping it open.
+     * @default false
+     */
+    disableHoverableContent?: boolean | undefined;
     /**
-     * Whether `PopoverContent` traps focus while open. Non-modal (the default)
-     * lets the rest of the page stay interactive.
+     * Whether the panel is suppressed: it never opens, never describes the trigger, and never fires `onOpenChange`.
      * @default false
      */
-    modal?: boolean;
+    disabled?: boolean | undefined;
 }
-/** Props for {@link PopoverTrigger}, the button that opens the popover and anchors its position. */
+/** Props for {@link PopoverTrigger}, the button that opens the popover and anchors its position; use `asChild` with an `<a href>` for a hover popover's link trigger. */
 export interface PopoverTriggerProps extends PrimitivePropsWithRef<'button'> {
 }
 /** Props for {@link PopoverPortal}, which teleports its children to `document.body`. */
 export interface PopoverPortalProps extends PortalProps {
     /**
-     * Render the portal even while the popover is closed, instead of
-     * unmounting it. Useful for animation libraries that need the outgoing
-     * content present in the DOM during an exit transition.
+     * Render the portal even while the popover is closed, instead of unmounting it.
      * @default false
      */
-    forceMount?: boolean;
+    forceMount?: boolean | undefined;
 }
-/**
- * Props for {@link PopoverContent}, the floating panel. Extends the shared
- * popper positioning props (`side`, `align`, `sideOffset`, `alignOffset`,
- * `avoidCollisions`, `collisionPadding`, `collisionBoundary`).
- */
+/** Props for {@link PopoverContent}, the floating panel, extending the shared popper positioning props. */
 export interface PopoverContentProps extends PopperContentProps {
     /**
-     * Keep this panel mounted even while the popover is closed. Useful for
-     * animation libraries that need the outgoing panel present in the DOM
-     * during an exit transition.
+     * Keep this panel mounted even while the popover is closed.
+     * @default false
+     */
+    forceMount?: boolean | undefined;
+    /**
+     * Clearance in pixels between the arrow and each end of the panel's edge, keeping it off rounded corners.
+     * @default 8
+     */
+    arrowPadding?: number | undefined;
+    /**
+     * Hide the panel (`visibility: hidden`) once its anchor scrolls fully out of view inside a clipping ancestor.
      * @default false
      */
-    forceMount?: boolean;
+    hideWhenDetached?: boolean | undefined;
+    /**
+     * CSS selector, resolved inside `PopoverContent`, for the element to focus when a focus-containing popover opens.
+     * @default undefined — the panel's first tabbable element, then the panel itself.
+     */
+    initialFocus?: string | undefined;
+    /**
+     * CSS selector for the element to focus when the popover closes, resolved at the document level.
+     * @default undefined — the trigger, or whatever was focused before opening.
+     */
+    finalFocus?: string | undefined;
     /**
      * Fires when Escape is pressed while the popover is open. Call `event.preventDefault()` to stop it from closing.
      * @default undefined — no-op if omitted.
      */
-    onEscapeKeyDown?: (event: KeyboardEvent) => void;
+    onEscapeKeyDown?: ((event: KeyboardEvent) => void) | undefined;
     /**
      * Fires on pointer-down outside the content. Call `event.preventDefault()` to stop the popover from closing.
      * @default undefined — no-op if omitted.
      */
-    onPointerDownOutside?: (event: PointerEvent) => void;
+    onPointerDownOutside?: ((event: PointerEvent) => void) | undefined;
     /**
-     * Fires when focus moves to an element outside the content. Call `event.preventDefault()` to stop the popover from closing. Receives a cancelable stand-in carrying the original `focusin` as its `detail`, since `focusin` itself cannot be canceled.
+     * Fires when focus moves outside the content, as a cancelable stand-in for the native `focusin`; call `event.preventDefault()` to stop it from closing.
      * @default undefined — no-op if omitted.
      */
-    onFocusOutside?: (event: FocusOutsideEvent) => void;
+    onFocusOutside?: ((event: FocusOutsideEvent) => void) | undefined;
     /**
-     * Fires for either kind of outside interaction — pointer-down or focus — immediately before the specific handler above and with the same event, so one `event.preventDefault()` here vetoes the dismissal whichever way it was triggered.
+     * Fires for either outside interaction — pointer-down or focus — before the specific handler, so one `event.preventDefault()` here vetoes either.
      * @default undefined — no-op if omitted.
      */
-    onInteractOutside?: (event: InteractOutsideEvent) => void;
+    onInteractOutside?: ((event: InteractOutsideEvent) => void) | undefined;
     /**
-     * Fires before focus moves into the content on open. Call `event.preventDefault()` to keep focus where it is and place it yourself. Modal popovers only — a non-modal popover never moves focus in.
+     * Fires before focus moves into the content on open, modal popovers only; call `event.preventDefault()` to place focus yourself.
      * @default undefined — focus moves to the first tabbable element.
      */
-    onOpenAutoFocus?: (event: AutoFocusEvent) => void;
+    onOpenAutoFocus?: ((event: AutoFocusEvent) => void) | undefined;
     /**
      * Fires before focus returns to the trigger (or, when `modal`, to whatever was focused before the popover opened). Call `event.preventDefault()` to suppress the return.
      * @default undefined — focus returns to the trigger.
      */
-    onCloseAutoFocus?: (event: AutoFocusEvent) => void;
+    onCloseAutoFocus?: ((event: AutoFocusEvent) => void) | undefined;
+}
+/** Props for {@link PopoverTitle}, the popover's accessible name. */
+export interface PopoverTitleProps extends PrimitivePropsWithRef<'h2'> {
+}
+/** Props for {@link PopoverDescription}, the popover's accessible description. */
+export interface PopoverDescriptionProps extends PrimitivePropsWithRef<'p'> {
 }
 /** Props for {@link PopoverClose}, a button that closes the popover. */
 export interface PopoverCloseProps extends PrimitivePropsWithRef<'button'> {

package/dist/primitives/accordion.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var n=Object.defineProperty;var s=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var P=Object.prototype.hasOwnProperty;var a=(r,o)=>{for(var e in o)n(r,e,{get:o[e],enumerable:!0})},g=(r,o,e,t)=>{if(o&&typeof o=="object"||typeof o=="function")for(let c of x(o))!P.call(r,c)&&c!==e&&n(r,c,{get:()=>o[c],enumerable:!(t=s(o,c))||t.enumerable});return r};var I=r=>g(n({},"__esModule",{value:!0}),r);var y={};a(y,{Accordion:()=>d.Accordion,AccordionContent:()=>f.AccordionContent,AccordionHeader:()=>p.AccordionHeader,AccordionIndicator:()=>m.AccordionIndicator,AccordionItem:()=>i.AccordionItem,AccordionTrigger:()=>A.AccordionTrigger});module.exports=I(y);var d=require("../accordion/Accordion.cjs"),i=require("../accordion/Accordion.cjs"),p=require("../accordion/Accordion.cjs"),A=require("../accordion/Accordion.cjs"),m=require("../accordion/Accordion.cjs"),f=require("../accordion/Accordion.cjs");0&&(module.exports={Accordion,AccordionContent,AccordionHeader,AccordionIndicator,AccordionItem,AccordionTrigger});

package/dist/primitives/accordion.js

@@ -0,0 +1,2 @@
+'use client';
+import{Accordion as c}from"../accordion/Accordion.js";import{AccordionItem as n}from"../accordion/Accordion.js";import{AccordionHeader as d}from"../accordion/Accordion.js";import{AccordionTrigger as p}from"../accordion/Accordion.js";import{AccordionIndicator as m}from"../accordion/Accordion.js";import{AccordionContent as s}from"../accordion/Accordion.js";export{c as Accordion,s as AccordionContent,d as AccordionHeader,m as AccordionIndicator,n as AccordionItem,p as AccordionTrigger};

package/dist/primitives/alert.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var p=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var n=Object.getOwnPropertyNames;var P=Object.prototype.hasOwnProperty;var y=(o,r)=>{for(var e in r)p(o,e,{get:r[e],enumerable:!0})},C=(o,r,e,l)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of n(r))!P.call(o,t)&&t!==e&&p(o,t,{get:()=>r[t],enumerable:!(l=c(r,t))||l.enumerable});return o};var D=o=>C(p({},"__esModule",{value:!0}),o);var I={};y(I,{AlertAction:()=>x.AlertAction,AlertClose:()=>m.AlertClose,AlertDescription:()=>i.AlertDescription,AlertIcon:()=>f.AlertIcon,AlertRoot:()=>A.AlertRoot,AlertTitle:()=>s.AlertTitle});module.exports=D(I);var A=require("../alert/Alert.cjs"),s=require("../alert/Alert.cjs"),i=require("../alert/Alert.cjs"),f=require("../alert/Alert.cjs"),m=require("../alert/Alert.cjs"),x=require("../alert/Alert.cjs");0&&(module.exports={AlertAction,AlertClose,AlertDescription,AlertIcon,AlertRoot,AlertTitle});

package/dist/primitives/alert.js

@@ -0,0 +1,2 @@
+'use client';
+import{AlertRoot as t}from"../alert/Alert.js";import{AlertTitle as p}from"../alert/Alert.js";import{AlertDescription as A}from"../alert/Alert.js";import{AlertIcon as i}from"../alert/Alert.js";import{AlertClose as m}from"../alert/Alert.js";import{AlertAction as c}from"../alert/Alert.js";export{c as AlertAction,m as AlertClose,A as AlertDescription,i as AlertIcon,t as AlertRoot,p as AlertTitle};

package/dist/primitives/angle-slider.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var p=Object.defineProperty;var S=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var s=Object.prototype.hasOwnProperty;var t=(e,r)=>{for(var o in r)p(e,o,{get:r[o],enumerable:!0})},f=(e,r,o,d)=>{if(r&&typeof r=="object"||typeof r=="function")for(let l of m(r))!s.call(e,l)&&l!==o&&p(e,l,{get:()=>r[l],enumerable:!(d=S(r,l))||d.enumerable});return e};var x=e=>f(p({},"__esModule",{value:!0}),e);var a={};t(a,{AngleSlider:()=>g.AngleSlider,AngleSliderMark:()=>A.AngleSliderMark,AngleSliderMarks:()=>n.AngleSliderMarks,AngleSliderThumb:()=>i.AngleSliderThumb});module.exports=x(a);var g=require("../angle-slider/AngleSlider.cjs"),i=require("../angle-slider/AngleSlider.cjs"),n=require("../angle-slider/AngleSlider.cjs"),A=require("../angle-slider/AngleSlider.cjs");0&&(module.exports={AngleSlider,AngleSliderMark,AngleSliderMarks,AngleSliderThumb});

package/dist/primitives/angle-slider.js

@@ -0,0 +1,2 @@
+'use client';
+import{AngleSlider as l}from"../angle-slider/AngleSlider.js";import{AngleSliderThumb as p}from"../angle-slider/AngleSlider.js";import{AngleSliderMarks as g}from"../angle-slider/AngleSlider.js";import{AngleSliderMark as n}from"../angle-slider/AngleSlider.js";export{l as AngleSlider,n as AngleSliderMark,g as AngleSliderMarks,p as AngleSliderThumb};

package/dist/primitives/autocomplete.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var r=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var C=Object.prototype.hasOwnProperty;var G=(t,o)=>{for(var p in o)r(t,p,{get:o[p],enumerable:!0})},I=(t,o,p,m)=>{if(o&&typeof o=="object"||typeof o=="function")for(let e of y(o))!C.call(t,e)&&e!==p&&r(t,e,{get:()=>o[e],enumerable:!(m=i(o,e))||m.enumerable});return t};var L=t=>I(r({},"__esModule",{value:!0}),t);var b={};G(b,{Autocomplete:()=>l.Autocomplete,AutocompleteClear:()=>A.AutocompleteClear,AutocompleteContent:()=>P.AutocompleteContent,AutocompleteEmpty:()=>a.AutocompleteEmpty,AutocompleteGroup:()=>n.AutocompleteGroup,AutocompleteGroupLabel:()=>g.AutocompleteGroupLabel,AutocompleteInput:()=>u.AutocompleteInput,AutocompleteItem:()=>x.AutocompleteItem,AutocompleteList:()=>f.AutocompleteList,AutocompletePortal:()=>s.AutocompletePortal,AutocompleteTrigger:()=>c.AutocompleteTrigger});module.exports=L(b);var l=require("../autocomplete/Autocomplete.cjs"),u=require("../autocomplete/Autocomplete.cjs"),c=require("../autocomplete/Autocomplete.cjs"),A=require("../autocomplete/Autocomplete.cjs"),s=require("../autocomplete/Autocomplete.cjs"),P=require("../autocomplete/Autocomplete.cjs"),f=require("../autocomplete/Autocomplete.cjs"),x=require("../autocomplete/Autocomplete.cjs"),a=require("../autocomplete/Autocomplete.cjs"),n=require("../autocomplete/Autocomplete.cjs"),g=require("../autocomplete/Autocomplete.cjs");0&&(module.exports={Autocomplete,AutocompleteClear,AutocompleteContent,AutocompleteEmpty,AutocompleteGroup,AutocompleteGroupLabel,AutocompleteInput,AutocompleteItem,AutocompleteList,AutocompletePortal,AutocompleteTrigger});