@skdx/react 0.28.0 → 0.30.0

package/dist/popover/Popover.d.cts

@@ -1,77 +1,45 @@
 import * as React from 'react';
+import { PopperAnchor } from '../utils/popper.cjs';
 import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
 import type { PopoverContextValue, PopoverProps } from './types.cjs';
-export declare const PopoverProvider: {
-    (props: PopoverContextValue & {
-        children: React.ReactNode;
-    }): React.JSX.Element;
-    displayName: string;
-}, usePopoverContext: (consumerName: string) => PopoverContextValue;
+export declare const PopoverContextProvider: React.FC<PopoverContextValue & {
+    children: React.ReactNode;
+}>, usePopoverContext: (consumerName: string) => PopoverContextValue;
 /** Props for {@link PopoverRoot}: {@link PopoverProps} minus the derived-anatomy-only props. */
 export type PopoverRootProps = Omit<PopoverProps, 'trigger' | 'title' | 'description' | 'side' | 'align' | 'showArrow'>;
-/**
- * State/context primitive that owns open state and hands it down to all popover
- * parts via context, wrapping in the popper positioning root with no DOM
- * element rendered. The `Popover` recipe (below) wraps this with
- * `PopoverAnatomy`, adding the derived anatomy. For full manual part
- * composition, use `PopoverRoot` from `@skdx/react/primitives/popover`.
- *
- * `reposition()` — the cross-framework positioning method for an anchor that
- * moved without the floating layer noticing — is accessed via context:
- * `usePopoverContext().reposition`, not a ref.
- */
-export declare function PopoverRoot({ children, open: openProp, defaultOpen, onOpenChange, onOpenChangeComplete, modal, }: PopoverRootProps): React.JSX.Element;
+/** State/context primitive that owns open state and hands it to all popover parts via context, rendering no DOM element itself. */
+export declare function PopoverRoot({ children, open: openProp, defaultOpen, onOpenChange, onOpenChangeComplete, modal: modalProp, openOn, role, openDelay: openDelayProp, closeDelay: closeDelayProp, disableHoverableContent: disableHoverableContentProp, disabled, }: PopoverRootProps): React.JSX.Element;
 export declare namespace PopoverRoot {
     var displayName: string;
 }
 /**
- * Recipe for a non-modal-by-default popover: owns open state and passes it to
- * all parts via context, rendering no DOM element itself. Derives the entire
- * anatomy from `trigger`/`title`/`description`: trigger (merged via `asChild`,
- * no wrapping), portal, and the panel with derived title, description, and
- * close button. `children` is the panel's body; the component reads only
- * whether it exists. Works controlled (`open` + `onOpenChange`) or uncontrolled
- * (`defaultOpen`).
- *
- * `PopoverContent` is `role="dialog"` and must have an accessible name: either
- * via `title` or, under manual composition without a visible heading, via
- * `aria-label` on `PopoverContent` itself.
- *
- * `reposition()` — the cross-framework positioning method for an anchor that
- * moved without the floating layer noticing — is accessed via context:
- * `usePopoverContext().reposition`, not a ref. For full manual composition,
- * use `PopoverRoot` from `@skdx/react/primitives/popover`.
+ * Recipe for a non-modal-by-default popover that derives its anatomy from `trigger`/`title`/`description`, or accepts a hand-composed part tree via `children`; `openOn="hover"` reveals it on pointer enter and `role="tooltip"` makes it an inert bubble.
  *
  * @example
  * ```tsx
  * <Popover trigger={<Button>Share</Button>} title="Share this page">
  *   <p>Anyone with the link can view it.</p>
  * </Popover>
- * ```
- *
- * @example Full manual composition — `@skdx/react/primitives/popover`.
- * ```tsx
- * import { PopoverArrow, PopoverClose, PopoverContent, PopoverDescription, PopoverPortal, PopoverRoot, PopoverTitle, PopoverTrigger } from '@skdx/react/primitives/popover';
  *
- * <PopoverRoot>
- *   <PopoverTrigger>Share</PopoverTrigger>
- *   <PopoverPortal>
- *     <PopoverContent side="bottom" align="start">
- *       <PopoverTitle>Share this page</PopoverTitle>
- *       <PopoverDescription>Anyone with the link can view it.</PopoverDescription>
- *       <PopoverArrow />
- *       <PopoverClose>Close</PopoverClose>
- *     </PopoverContent>
- *   </PopoverPortal>
- * </PopoverRoot>
+ * <Popover
+ *   role="tooltip"
+ *   openOn="hover"
+ *   side="top"
+ *   trigger={<IconButton aria-label="Copy" icon={<CopyIcon />} />}
+ * >
+ *   Copy
+ * </Popover>
  * ```
  */
-export declare function Popover({ children, open, defaultOpen, onOpenChange, onOpenChangeComplete, modal, trigger, title, description, side, align, showArrow, ...rest }: PopoverProps): React.JSX.Element;
+export declare function Popover({ children, open, defaultOpen, onOpenChange, onOpenChangeComplete, modal, openOn, role, openDelay, closeDelay, disableHoverableContent, disabled, trigger, title, description, side, align, showArrow, ...rest }: PopoverProps): React.JSX.Element;
 export declare namespace Popover {
     var displayName: string;
 }
 /** Positions the popover against a custom element instead of the trigger. */
-export declare const PopoverAnchor: React.ForwardRefExoticComponent<Omit<PrimitivePropsWithRef<"div">, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const PopoverAnchor: {
+    ({ ref, ...props }: Omit<React.ComponentPropsWithRef<typeof PopperAnchor>, "explicit">): React.ReactNode;
+    displayName: string;
+};
 /**
  * Optional visual arrow pointing from `PopoverContent` back at the anchor.
  * Must be rendered inside `PopoverContent`; self-positions based on the
@@ -85,4 +53,7 @@ export declare const PopoverAnchor: React.ForwardRefExoticComponent<Omit<Primiti
  * </PopoverContent>
  * ```
  */
-export declare const PopoverArrow: React.ForwardRefExoticComponent<Omit<PrimitivePropsWithRef<"span">, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const PopoverArrow: {
+    ({ ref: forwardedRef, ...props }: PrimitivePropsWithRef<"span">): React.ReactNode;
+    displayName: string;
+};

package/dist/popover/Popover.d.ts

@@ -1,77 +1,45 @@
 import * as React from 'react';
+import { PopperAnchor } from '../utils/popper.js';
 import type { PrimitivePropsWithRef } from '../utils/primitive.js';
 import type { PopoverContextValue, PopoverProps } from './types.js';
-export declare const PopoverProvider: {
-    (props: PopoverContextValue & {
-        children: React.ReactNode;
-    }): React.JSX.Element;
-    displayName: string;
-}, usePopoverContext: (consumerName: string) => PopoverContextValue;
+export declare const PopoverContextProvider: React.FC<PopoverContextValue & {
+    children: React.ReactNode;
+}>, usePopoverContext: (consumerName: string) => PopoverContextValue;
 /** Props for {@link PopoverRoot}: {@link PopoverProps} minus the derived-anatomy-only props. */
 export type PopoverRootProps = Omit<PopoverProps, 'trigger' | 'title' | 'description' | 'side' | 'align' | 'showArrow'>;
-/**
- * State/context primitive that owns open state and hands it down to all popover
- * parts via context, wrapping in the popper positioning root with no DOM
- * element rendered. The `Popover` recipe (below) wraps this with
- * `PopoverAnatomy`, adding the derived anatomy. For full manual part
- * composition, use `PopoverRoot` from `@skdx/react/primitives/popover`.
- *
- * `reposition()` — the cross-framework positioning method for an anchor that
- * moved without the floating layer noticing — is accessed via context:
- * `usePopoverContext().reposition`, not a ref.
- */
-export declare function PopoverRoot({ children, open: openProp, defaultOpen, onOpenChange, onOpenChangeComplete, modal, }: PopoverRootProps): React.JSX.Element;
+/** State/context primitive that owns open state and hands it to all popover parts via context, rendering no DOM element itself. */
+export declare function PopoverRoot({ children, open: openProp, defaultOpen, onOpenChange, onOpenChangeComplete, modal: modalProp, openOn, role, openDelay: openDelayProp, closeDelay: closeDelayProp, disableHoverableContent: disableHoverableContentProp, disabled, }: PopoverRootProps): React.JSX.Element;
 export declare namespace PopoverRoot {
     var displayName: string;
 }
 /**
- * Recipe for a non-modal-by-default popover: owns open state and passes it to
- * all parts via context, rendering no DOM element itself. Derives the entire
- * anatomy from `trigger`/`title`/`description`: trigger (merged via `asChild`,
- * no wrapping), portal, and the panel with derived title, description, and
- * close button. `children` is the panel's body; the component reads only
- * whether it exists. Works controlled (`open` + `onOpenChange`) or uncontrolled
- * (`defaultOpen`).
- *
- * `PopoverContent` is `role="dialog"` and must have an accessible name: either
- * via `title` or, under manual composition without a visible heading, via
- * `aria-label` on `PopoverContent` itself.
- *
- * `reposition()` — the cross-framework positioning method for an anchor that
- * moved without the floating layer noticing — is accessed via context:
- * `usePopoverContext().reposition`, not a ref. For full manual composition,
- * use `PopoverRoot` from `@skdx/react/primitives/popover`.
+ * Recipe for a non-modal-by-default popover that derives its anatomy from `trigger`/`title`/`description`, or accepts a hand-composed part tree via `children`; `openOn="hover"` reveals it on pointer enter and `role="tooltip"` makes it an inert bubble.
  *
  * @example
  * ```tsx
  * <Popover trigger={<Button>Share</Button>} title="Share this page">
  *   <p>Anyone with the link can view it.</p>
  * </Popover>
- * ```
- *
- * @example Full manual composition — `@skdx/react/primitives/popover`.
- * ```tsx
- * import { PopoverArrow, PopoverClose, PopoverContent, PopoverDescription, PopoverPortal, PopoverRoot, PopoverTitle, PopoverTrigger } from '@skdx/react/primitives/popover';
  *
- * <PopoverRoot>
- *   <PopoverTrigger>Share</PopoverTrigger>
- *   <PopoverPortal>
- *     <PopoverContent side="bottom" align="start">
- *       <PopoverTitle>Share this page</PopoverTitle>
- *       <PopoverDescription>Anyone with the link can view it.</PopoverDescription>
- *       <PopoverArrow />
- *       <PopoverClose>Close</PopoverClose>
- *     </PopoverContent>
- *   </PopoverPortal>
- * </PopoverRoot>
+ * <Popover
+ *   role="tooltip"
+ *   openOn="hover"
+ *   side="top"
+ *   trigger={<IconButton aria-label="Copy" icon={<CopyIcon />} />}
+ * >
+ *   Copy
+ * </Popover>
  * ```
  */
-export declare function Popover({ children, open, defaultOpen, onOpenChange, onOpenChangeComplete, modal, trigger, title, description, side, align, showArrow, ...rest }: PopoverProps): React.JSX.Element;
+export declare function Popover({ children, open, defaultOpen, onOpenChange, onOpenChangeComplete, modal, openOn, role, openDelay, closeDelay, disableHoverableContent, disabled, trigger, title, description, side, align, showArrow, ...rest }: PopoverProps): React.JSX.Element;
 export declare namespace Popover {
     var displayName: string;
 }
 /** Positions the popover against a custom element instead of the trigger. */
-export declare const PopoverAnchor: React.ForwardRefExoticComponent<Omit<PrimitivePropsWithRef<"div">, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const PopoverAnchor: {
+    ({ ref, ...props }: Omit<React.ComponentPropsWithRef<typeof PopperAnchor>, "explicit">): React.ReactNode;
+    displayName: string;
+};
 /**
  * Optional visual arrow pointing from `PopoverContent` back at the anchor.
  * Must be rendered inside `PopoverContent`; self-positions based on the
@@ -85,4 +53,7 @@ export declare const PopoverAnchor: React.ForwardRefExoticComponent<Omit<Primiti
  * </PopoverContent>
  * ```
  */
-export declare const PopoverArrow: React.ForwardRefExoticComponent<Omit<PrimitivePropsWithRef<"span">, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const PopoverArrow: {
+    ({ ref: forwardedRef, ...props }: PrimitivePropsWithRef<"span">): React.ReactNode;
+    displayName: string;
+};

package/dist/popover/Popover.js

@@ -1 +1,2 @@
-import*as s from"react";import{createSafeContext as xo}from"../utils/createContext.js";import{skdxPart as To}from"../utils/part.js";import{PopperAnchor as wo,PopperArrow as bo,PopperRoot as Eo}from"../utils/popper.js";import{useControllableState as ko}from"../utils/useControllableState.js";import{useOpenChangeComplete as Do}from"../utils/useOpenChangeComplete.js";import*as M from"react";import{skdxPart as V}from"../utils/part.js";import{composeEventHandlers as K,Primitive as z}from"../utils/primitive.js";import{jsx as G}from"react/jsx-runtime";var E=M.forwardRef((o,e)=>{let t=i("PopoverClose");return G(z.button,{type:"button",...o,...V("popover","close",o.className),ref:e,onClick:K(o.onClick,()=>t.onOpenChange(!1))})});E.displayName="PopoverClose";import*as T from"react";import{useComposedRefs as Q}from"../utils/composeRefs.js";import{isDevMode as U}from"../utils/is-dev-mode.js";import{skdxPart as X}from"../utils/part.js";import{PopperContent as Y}from"../utils/popper.js";import{TABBABLE_SELECTOR as Z}from"../utils/tabbable.js";import{useBodyScrollLock as j}from"../utils/useBodyScrollLock.js";import{useDismiss as oo}from"../utils/useDismiss.js";import{autoFocusEvent as eo,useFocusTrap as to}from"../utils/useFocusTrap.js";import{useOutsideInert as ro}from"../utils/useOutsideInert.js";import{isDevMode as N}from"../utils/is-dev-mode.js";function k(o,e,t){if(!e)return null;let n;try{n=o.querySelector(e)}catch{return N()&&console.warn(`[skdx] Popover: ${t}="${e}" is not a valid CSS selector. Falling back to the default focus target.`),null}return!n&&N()&&console.warn(J(t,e)),n}function J(o,e){return o==="initialFocus"?`[skdx] Popover: initialFocus="${e}" matched no element inside the popover panel. Falling back to the first tabbable element, then the panel itself.`:`[skdx] Popover: finalFocus="${e}" matched no element in the document. Falling back to the trigger.`}import{jsx as po}from"react/jsx-runtime";function no(o,e){T.useEffect(()=>{if(!U()||!e)return;let t=o.current;!t||t.querySelector(".skdx-popover__close")||console.warn("[skdx] Popover: `modal` contains focus inside PopoverContent, but no PopoverClose was rendered inside it. A user who cannot press Escape \u2014 a touch screen-reader user has no Escape key \u2014 has no way out of the panel. Render a PopoverClose, or set `modal={false}`.")},[o,e])}var D=T.forwardRef(({forceMount:o,onEscapeKeyDown:e,onPointerDownOutside:t,onFocusOutside:n,onInteractOutside:f,onOpenAutoFocus:m,onCloseAutoFocus:c,sideOffset:a=4,arrowPadding:R=8,initialFocus:u,finalFocus:d,...P},v)=>{let r=i("PopoverContent"),C=Q(v,r.contentRef),y=()=>{let p=k(document,d,"finalFocus");return p?(p.focus({preventScroll:!0}),!0):!1},x=r.modal!==!1,_=r.modal===!0;return j(r.open&&_),ro(r.contentRef,r.open&&x),to(r.contentRef,r.open&&x,{onOpenAutoFocus:p=>{if(m?.(p),p.defaultPrevented||!u)return;let g=r.contentRef.current;if(!g)return;let L=k(g,u,"initialFocus")??g.querySelector(Z)??g;p.preventDefault(),L===g&&g.setAttribute("tabindex","-1"),L.focus({preventScroll:!0})},onCloseAutoFocus:p=>{c?.(p),!(p.defaultPrevented||!d)&&y()&&p.preventDefault()}}),no(r.contentRef,r.open&&x),oo({enabled:r.open,onEscapeKeyDown:p=>{e?.(p),!p.defaultPrevented&&(r.onOpenChange(!1),x?r.triggerRef.current?.focus():eo("close-auto-focus",c)&&(y()||r.triggerRef.current?.focus()))},onInteractOutside:f,onPointerDownOutside:p=>{t?.(p),p.defaultPrevented||r.onOpenChange(!1)},onFocusOutside:p=>{n?.(p),p.defaultPrevented||r.onOpenChange(!1)}},[r.contentRef,r.triggerRef]),o||r.open?po(Y,{component:"popover",role:"dialog","aria-labelledby":r.hasTitle?r.titleId:void 0,"aria-describedby":r.hasDescription?r.descriptionId:void 0,id:r.contentId,"data-state":r.open?"open":"closed",sideOffset:a,arrowPadding:R,...P,...X("popover","content",P.className),ref:C}):null});D.displayName="PopoverContent";import*as w from"react";import{skdxPart as so}from"../utils/part.js";import{Primitive as io}from"../utils/primitive.js";import{jsx as ao}from"react/jsx-runtime";var H=w.forwardRef((o,e)=>{let t=i("PopoverDescription"),{setHasDescription:n}=t;return w.useEffect(()=>(n(!0),()=>n(!1)),[n]),ao(io.p,{id:t.descriptionId,...o,...so("popover","description",o.className),ref:e})});H.displayName="PopoverDescription";import{Portal as lo}from"../utils/portal.js";import{jsx as co}from"react/jsx-runtime";var A=({forceMount:o,children:e,...t})=>{let n=i("PopoverPortal");return o||n.open?co(lo,{...t,children:e}):null};A.displayName="PopoverPortal";import*as b from"react";import{skdxPart as fo}from"../utils/part.js";import{Primitive as mo}from"../utils/primitive.js";import{jsx as uo}from"react/jsx-runtime";var O=b.forwardRef((o,e)=>{let t=i("PopoverTitle"),{setHasTitle:n}=t;return b.useEffect(()=>(n(!0),()=>n(!1)),[n]),uo(mo.h2,{id:t.titleId,...o,...fo("popover","title",o.className),ref:e})});O.displayName="PopoverTitle";import*as B from"react";import{useComposedRefs as Po}from"../utils/composeRefs.js";import{skdxPart as vo}from"../utils/part.js";import{PopperAnchor as go}from"../utils/popper.js";import{composeEventHandlers as Ro,Primitive as ho}from"../utils/primitive.js";import{jsx as I}from"react/jsx-runtime";var F=B.forwardRef((o,e)=>{let t=i("PopoverTrigger"),n=Po(e,t.triggerRef);return I(go,{asChild:!0,children:I(ho.button,{type:"button","aria-haspopup":"dialog","aria-expanded":t.open,"aria-controls":t.contentId,"data-state":t.open?"open":"closed",...o,...vo("popover","trigger",o.className),ref:n,onClick:Ro(o.onClick,()=>t.onOpenChange(!t.open))})})});F.displayName="PopoverTrigger";import{Fragment as yo,jsx as l,jsxs as W}from"react/jsx-runtime";var Co=()=>l("svg",{viewBox:"0 0 16 16",width:"1em",height:"1em",fill:"none","aria-hidden":"true",focusable:"false",children:l("path",{d:"M4 4l8 8M12 4l-8 8",stroke:"currentColor",strokeWidth:"1.5",strokeLinecap:"round"})}),q=({trigger:o,title:e,description:t,side:n,align:f,showArrow:m,children:c,passThrough:a})=>W(yo,{children:[o?l(F,{asChild:!0,...a?.id?{"aria-controls":a.id}:{},children:o}):null,l(A,{children:W(D,{...a,side:n,align:f,children:[e?l(O,{children:e}):null,t?l(H,{children:t}):null,c,m?l(S,{}):null,l(E,{"aria-label":"Close",children:l(Co,{})})]})})]});import{jsx as h}from"react/jsx-runtime";var[Ho,i]=xo("Popover");function $({children:o,open:e,defaultOpen:t=!1,onOpenChange:n,onOpenChangeComplete:f,modal:m=!1}){let c=s.useRef(null),a=s.useRef(null),[R,u]=s.useState(!1),[d,P]=s.useState(!1),[v=!1,r]=ko({prop:e,defaultProp:t,onChange:n});Do(v,a,f);let C=s.useRef(null),y=s.useCallback(()=>{C.current?.()},[]);return h(Eo,{updateRef:C,children:h(Ho,{triggerRef:c,contentRef:a,contentId:s.useId(),titleId:s.useId(),descriptionId:s.useId(),hasTitle:R,setHasTitle:u,hasDescription:d,setHasDescription:P,open:v,onOpenChange:r,modal:m,reposition:y,children:o})})}$.displayName="PopoverRoot";function Ao({children:o,open:e,defaultOpen:t,onOpenChange:n,onOpenChangeComplete:f,modal:m,trigger:c,title:a,description:R,side:u,align:d,showArrow:P=!1,...v}){return h($,{open:e,defaultOpen:t,onOpenChange:n,onOpenChangeComplete:f,modal:m,children:h(q,{trigger:c,title:a,description:R,side:u,align:d,showArrow:P,passThrough:v,children:o})})}Ao.displayName="Popover";var Se=wo,S=s.forwardRef((o,e)=>h(bo,{...o,...To("popover","arrow",o.className),ref:e}));S.displayName="PopoverArrow";export{Ao as Popover,Se as PopoverAnchor,S as PopoverArrow,E as PopoverClose,D as PopoverContent,H as PopoverDescription,A as PopoverPortal,Ho as PopoverProvider,$ as PopoverRoot,O as PopoverTitle,F as PopoverTrigger,i as usePopoverContext};
+'use client';
+import*as s from"react";import{createSafeContext as Qe}from"../utils/createContext.js";import{skdxPart as Y}from"../utils/part.js";import{PopperAnchor as Ue,PopperArrow as Ye,PopperRoot as Ze}from"../utils/popper.js";import{useControllableState as $e}from"../utils/useControllableState.js";import{useOpenChangeComplete as je}from"../utils/useOpenChangeComplete.js";import{Glyph as Me}from"../utils/Glyph.js";import{skdxPart as ce}from"../utils/part.js";import{composeEventHandlers as fe,Primitive as ue}from"../utils/primitive.js";import{jsx as de}from"react/jsx-runtime";var A=({ref:e,...t})=>{let o=u("PopoverClose");return de(ue.button,{type:"button",...t,...ce("popover","close",t.className),ref:e,onClick:fe(t.onClick,()=>o.onOpenChange(!1))})};A.displayName="PopoverClose";import*as _ from"react";import{useComposedRefs as me}from"../utils/composeRefs.js";import{isDevMode as Pe}from"../utils/dev-mode.js";import{applyFinalFocus as ve,initialFocusTarget as Re,returnFocus as ye}from"../utils/focus-targets.js";import{skdxPart as Ce}from"../utils/part.js";import{PopperContent as he}from"../utils/popper.js";import{composeEventHandlers as W}from"../utils/primitive.js";import{useBodyScrollLock as ge}from"../utils/useBodyScrollLock.js";import{useDismiss as be}from"../utils/useDismiss.js";import{useFocusTrap as Oe}from"../utils/useFocusTrap.js";import{useOutsideInert as De}from"../utils/useOutsideInert.js";import{jsx as xe}from"react/jsx-runtime";function Te(e,t){_.useEffect(()=>{if(!Pe()||!t)return;let o=e.current;!o||o.querySelector(".skdx-popover__close")||console.warn('[skdx] Popover: `modal` contains focus inside PopoverContent, but no PopoverClose was rendered inside it. A user who cannot press Escape \u2014 a touch screen-reader user has no Escape key \u2014 has no way out of the panel. Render a PopoverClose, or set `modal="none"`.')},[e,t])}function we(e,{initialFocus:t,finalFocus:o,onEscapeKeyDown:i,onPointerDownOutside:l,onFocusOutside:a,onInteractOutside:c,onOpenAutoFocus:p,onCloseAutoFocus:f}){let P=e.role==="tooltip",m=e.modal!=="none",d=e.open&&m;ge(e.open&&e.modal==="modal"),De(e.contentRef,d),Oe(e.contentRef,d,{onOpenAutoFocus:r=>{if(p?.(r),r.defaultPrevented||!t)return;let n=e.contentRef.current;if(!n)return;let y=Re(n,t,"Popover");r.preventDefault(),y===n&&n.setAttribute("tabindex","-1"),y.focus({preventScroll:!0})},onCloseAutoFocus:r=>{f?.(r),!(r.defaultPrevented||!o)&&ve(o,"Popover")&&r.preventDefault()}}),Te(e.contentRef,d),be({enabled:e.open,onEscapeKeyDown:r=>{if(i?.(r),!r.defaultPrevented){if(P){e.onClose();return}e.onClose(),m?e.triggerRef.current?.focus():ye(o,"Popover",e.triggerRef.current,f)}},onInteractOutside:c,onPointerDownOutside:r=>{l?.(r),!r.defaultPrevented&&!P&&e.onOpenChange(!1)},onFocusOutside:r=>{a?.(r),!r.defaultPrevented&&!P&&e.onOpenChange(!1)}},[e.contentRef,e.triggerRef])}var N=({forceMount:e,onEscapeKeyDown:t,onPointerDownOutside:o,onFocusOutside:i,onInteractOutside:l,onOpenAutoFocus:a,onCloseAutoFocus:c,sideOffset:p=4,arrowPadding:f=8,initialFocus:P,finalFocus:m,ref:d,...r})=>{let n=u("PopoverContent"),y=me(d,n.contentRef),C=n.role==="tooltip",D=n.openOn==="hover",O=D&&n.hoverable;return we(n,{initialFocus:P,finalFocus:m,onEscapeKeyDown:t,onPointerDownOutside:o,onFocusOutside:i,onInteractOutside:l,onOpenAutoFocus:a,onCloseAutoFocus:c}),e||n.open?xe(he,{component:"popover",role:C?"tooltip":"dialog","aria-labelledby":!C&&n.hasTitle?n.titleId:void 0,"aria-describedby":!C&&n.hasDescription?n.descriptionId:void 0,id:n.contentId,"data-state":n.state,"data-hoverable":O?"":void 0,sideOffset:p,arrowPadding:f,...r,...Ce("popover","content",r.className),ref:y,onPointerEnter:W(r.onPointerEnter,h=>{O&&h.pointerType!=="touch"&&n.onOpen()}),onPointerLeave:W(r.onPointerLeave,h=>{O&&h.pointerType!=="touch"&&n.onClose()}),style:D?{pointerEvents:O?"auto":"none",...r.style}:r.style}):null};N.displayName="PopoverContent";import*as K from"react";import{skdxPart as ke}from"../utils/part.js";import{Primitive as Ee}from"../utils/primitive.js";import{jsx as Ae}from"react/jsx-runtime";var H=({ref:e,...t})=>{let o=u("PopoverDescription"),{setHasDescription:i}=o;return K.useEffect(()=>(i(!0),()=>i(!1)),[i]),Ae(Ee.p,{id:o.descriptionId,...t,...ke("popover","description",t.className),ref:e})};H.displayName="PopoverDescription";import{Portal as Ne}from"../utils/portal.js";import{jsx as He}from"react/jsx-runtime";var S=({forceMount:e,children:t,...o})=>{let i=u("PopoverPortal");return e||i.open?He(Ne,{...o,children:t}):null};S.displayName="PopoverPortal";import*as q from"react";import{skdxPart as Se}from"../utils/part.js";import{Primitive as Ie}from"../utils/primitive.js";import{jsx as Fe}from"react/jsx-runtime";var I=({ref:e,...t})=>{let o=u("PopoverTitle"),{setHasTitle:i}=o;return q.useEffect(()=>(i(!0),()=>i(!1)),[i]),Fe(Ie.h2,{id:o.titleId,...t,...Se("popover","title",t.className),ref:e})};I.displayName="PopoverTitle";import{useComposedRefs as Le}from"../utils/composeRefs.js";import{skdxPart as Be}from"../utils/part.js";import{PopperAnchor as Ve}from"../utils/popper.js";import{composeEventHandlers as w,Primitive as Je}from"../utils/primitive.js";import{jsx as G}from"react/jsx-runtime";var F=({ref:e,...t})=>{let o=u("PopoverTrigger"),i=Le(e,o.triggerRef),l=o.role==="tooltip",a=o.openOn==="hover",c=l||a;return G(Ve,{asChild:!0,children:G(Je.button,{type:"button",...c?{"aria-describedby":o.open?o.contentId:void 0}:{"aria-haspopup":"dialog","aria-expanded":o.open,"aria-controls":o.contentId},"data-state":o.state,...t,...Be("popover","trigger",t.className),ref:i,onPointerEnter:w(t.onPointerEnter,p=>{a&&p.pointerType!=="touch"&&o.onDelayedOpen()}),onPointerLeave:w(t.onPointerLeave,p=>{a&&p.pointerType!=="touch"&&o.onDelayedClose()}),onFocus:w(t.onFocus,()=>{l&&o.onOpen()}),onBlur:w(t.onBlur,()=>{l&&o.onClose()}),onClick:w(t.onClick,()=>{l?o.onClose():a||o.onOpenChange(!o.open)})})})};F.displayName="PopoverTrigger";import{Fragment as _e,jsx as g,jsxs as z}from"react/jsx-runtime";var Xe=()=>g(Me,{name:"close"});function We(e,t,o){return e?t?o?{"aria-describedby":e}:{}:{"aria-controls":e}:{}}var Q=({trigger:e,title:t,description:o,side:i,align:l,showArrow:a,children:c,passThrough:p})=>{let f=u("PopoverAnatomy"),P=f.role==="tooltip"||f.openOn==="hover",m=f.role==="dialog"&&f.openOn==="click";return z(_e,{children:[e?g(F,{asChild:!0,...We(p?.id,P,f.open),children:e}):null,g(S,{children:z(N,{...p,side:i,align:l,children:[t&&m?g(I,{children:t}):null,o&&m?g(H,{children:o}):null,c,a?g(L,{}):null,m?g(A,{"aria-label":"Close",children:g(Xe,{})}):null]})})]})};import*as b from"react";import{createSafeContext as Ke}from"../utils/createContext.js";import{jsx as ze}from"react/jsx-runtime";var[qe,U]=Ke("PopoverProvider",{delayDuration:700,skipDelayDuration:300,closeDelay:0,disableHoverableContent:!1,isOpenDelayedRef:{current:!0},onOpen:()=>{},onClose:()=>{}});function Ge({children:e,delayDuration:t=700,skipDelayDuration:o=300,closeDelay:i=0,disableHoverableContent:l=!1}){let a=b.useRef(!0),c=b.useRef(0);b.useEffect(()=>()=>window.clearTimeout(c.current),[]);let p=b.useCallback(()=>{window.clearTimeout(c.current),a.current=!1},[]),f=b.useCallback(()=>{window.clearTimeout(c.current),c.current=window.setTimeout(()=>{a.current=!0},o)},[o]);return ze(qe,{delayDuration:t,skipDelayDuration:o,closeDelay:i,disableHoverableContent:l,isOpenDelayedRef:a,onOpen:p,onClose:f,children:e})}Ge.displayName="PopoverProvider";import{jsx as T}from"react/jsx-runtime";var[eo,u]=Qe("Popover"),oo=150;function to(e,t){return t?Math.max(e,oo):e}function ro(e,t,o){return e?t?o?"delayed-open":"instant-open":"open":"closed"}function Z({children:e,open:t,defaultOpen:o=!1,onOpenChange:i,onOpenChangeComplete:l,modal:a="none",openOn:c="click",role:p="dialog",openDelay:f,closeDelay:P,disableHoverableContent:m,disabled:d=!1}){let r=U("Popover"),n=p==="tooltip",y=n?"none":a,C=f??(n?r.delayDuration:700),D=P??(n?r.closeDelay:300),h=!(m??(n?r.disableHoverableContent:!1)),$=s.useRef(null),B=s.useRef(null),V=s.useRef(0),J=s.useRef(0),[j,x]=s.useState(!0),[ee,oe]=s.useState(!1),[te,re]=s.useState(!1),[ne=!1,v]=$e({prop:t,defaultProp:o,onChange:X=>{n&&(X?r.onOpen():r.onClose()),i?.(X)}}),k=d?!1:ne;je(k,B,l);let R=s.useCallback(()=>{window.clearTimeout(V.current),window.clearTimeout(J.current)},[]);s.useEffect(()=>R,[R]);let ie=s.useCallback(()=>{d||(R(),x(!1),v(!0))},[R,v,d]),se=s.useCallback(()=>{if(!d){if(R(),!r.isOpenDelayedRef.current){x(!1),v(!0);return}V.current=window.setTimeout(()=>{x(!0),v(!0)},C)}},[R,v,C,r.isOpenDelayedRef,d]),ae=s.useCallback(()=>{R(),v(!1)},[R,v]),E=to(D,h),pe=s.useCallback(()=>{if(R(),E<=0){v(!1);return}J.current=window.setTimeout(()=>v(!1),E)},[R,v,E]),M=s.useRef(null),le=s.useCallback(()=>{M.current?.()},[]);return T(Ze,{updateRef:M,children:T(eo,{triggerRef:$,contentRef:B,contentId:s.useId(),titleId:s.useId(),descriptionId:s.useId(),hasTitle:ee,setHasTitle:oe,hasDescription:te,setHasDescription:re,open:k,onOpenChange:v,modal:y,role:p,openOn:c,state:ro(k,n,j),hoverable:h,onOpen:ie,onDelayedOpen:se,onClose:ae,onDelayedClose:pe,reposition:le,children:e})})}Z.displayName="PopoverRoot";function no({children:e,open:t,defaultOpen:o,onOpenChange:i,onOpenChangeComplete:l,modal:a,openOn:c,role:p,openDelay:f,closeDelay:P,disableHoverableContent:m,disabled:d,trigger:r,title:n,description:y,side:C,align:D,showArrow:O=!1,...h}){return T(Z,{open:t,defaultOpen:o,onOpenChange:i,onOpenChangeComplete:l,modal:a,openOn:c,role:p,openDelay:f,closeDelay:P,disableHoverableContent:m,disabled:d,children:T(Q,{trigger:r,title:n,description:y,side:C,align:D,showArrow:O,passThrough:h,children:e})})}no.displayName="Popover";var io=({ref:e,...t})=>T(Ue,{explicit:!0,ref:e,...t,...Y("popover","anchor",t.className)});io.displayName="PopoverAnchor";var L=({ref:e,...t})=>T(Ye,{...t,...Y("popover","arrow",t.className),ref:e});L.displayName="PopoverArrow";export{no as Popover,io as PopoverAnchor,L as PopoverArrow,A as PopoverClose,N as PopoverContent,eo as PopoverContextProvider,H as PopoverDescription,S as PopoverPortal,Ge as PopoverProvider,qe as PopoverProviderContext,Z as PopoverRoot,I as PopoverTitle,F as PopoverTrigger,u as usePopoverContext,U as usePopoverProviderContext};

package/dist/popover/PopoverAnatomy.d.cts

@@ -1,21 +1,14 @@
 import type * as React from 'react';
 import type { PassThroughProps } from '../utils/passThrough.cjs';
 import type { Align, Side } from '../utils/popper.cjs';
-/**
- * The anatomy a {@link Popover} draws for plain body content: trigger (via
- * `asChild`, when given), portal, panel with derived title/description, body,
- * arrow (if `showArrow`), and close button. A focus-trapping modal must
- * always offer an exit.
- *
- * @internal
- */
+/** @internal The anatomy a {@link Popover} draws for plain body content: trigger, portal, panel, and close button. */
 export declare const PopoverAnatomy: ({ trigger, title, description, side, align, showArrow, children, passThrough, }: {
-    trigger?: React.ReactElement;
-    title?: string;
-    description?: string;
-    side?: Side;
-    align?: Align;
+    trigger?: React.ReactElement | undefined;
+    title?: string | undefined;
+    description?: string | undefined;
+    side?: Side | undefined;
+    align?: Align | undefined;
     showArrow: boolean;
-    children?: React.ReactNode;
-    passThrough?: PassThroughProps;
+    children?: React.ReactNode | undefined;
+    passThrough?: PassThroughProps | undefined;
 }) => React.JSX.Element;

package/dist/popover/PopoverAnatomy.d.ts

@@ -1,21 +1,14 @@
 import type * as React from 'react';
 import type { PassThroughProps } from '../utils/passThrough.js';
 import type { Align, Side } from '../utils/popper.js';
-/**
- * The anatomy a {@link Popover} draws for plain body content: trigger (via
- * `asChild`, when given), portal, panel with derived title/description, body,
- * arrow (if `showArrow`), and close button. A focus-trapping modal must
- * always offer an exit.
- *
- * @internal
- */
+/** @internal The anatomy a {@link Popover} draws for plain body content: trigger, portal, panel, and close button. */
 export declare const PopoverAnatomy: ({ trigger, title, description, side, align, showArrow, children, passThrough, }: {
-    trigger?: React.ReactElement;
-    title?: string;
-    description?: string;
-    side?: Side;
-    align?: Align;
+    trigger?: React.ReactElement | undefined;
+    title?: string | undefined;
+    description?: string | undefined;
+    side?: Side | undefined;
+    align?: Align | undefined;
     showArrow: boolean;
-    children?: React.ReactNode;
-    passThrough?: PassThroughProps;
+    children?: React.ReactNode | undefined;
+    passThrough?: PassThroughProps | undefined;
 }) => React.JSX.Element;

package/dist/popover/PopoverClose.d.cts

@@ -1,4 +1,4 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { PopoverCloseProps } from './types.cjs';
 /**
  * Button that closes the popover when clicked. Renders inside
@@ -11,4 +11,7 @@ import type { PopoverCloseProps } from './types.cjs';
  * </PopoverContent>
  * ```
  */
-export declare const PopoverClose: React.ForwardRefExoticComponent<Omit<PopoverCloseProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export declare const PopoverClose: {
+    ({ ref: forwardedRef, ...props }: PopoverCloseProps): React.ReactNode;
+    displayName: string;
+};

package/dist/popover/PopoverClose.d.ts

@@ -1,4 +1,4 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { PopoverCloseProps } from './types.js';
 /**
  * Button that closes the popover when clicked. Renders inside
@@ -11,4 +11,7 @@ import type { PopoverCloseProps } from './types.js';
  * </PopoverContent>
  * ```
  */
-export declare const PopoverClose: React.ForwardRefExoticComponent<Omit<PopoverCloseProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export declare const PopoverClose: {
+    ({ ref: forwardedRef, ...props }: PopoverCloseProps): React.ReactNode;
+    displayName: string;
+};

package/dist/popover/PopoverContent.d.cts

@@ -1,36 +1,7 @@
 import * as React from 'react';
 import type { PopoverContentProps } from './types.cjs';
 /**
- * The popover's floating panel: `role="dialog"` with `data-state`
- * (`open`/`closed`), named by `PopoverTitle` and described by
- * `PopoverDescription` through `aria-labelledby`/`aria-describedby` — each
- * emitted only while that part is mounted, so an omitted part leaves no
- * reference behind rather than one pointing at nothing. Positioned via the
- * shared popper layer against the
- * trigger (or `PopoverAnchor`) using `side`/`align`/`sideOffset` (defaults
- * to `4`, overriding the popper default of `0`)/`alignOffset` and flipping/
- * shifting to avoid viewport collisions unless `avoidCollisions` is `false`.
- * `arrowPadding` keeps the arrow clear of the panel's rounded corners, and
- * `hideWhenDetached` hides the panel — without closing or unmounting it — while
- * its anchor is scrolled out of view inside a clipping ancestor.
- * Also exposes `data-side`/`data-align` reflecting the resolved placement, and
- * the measurement custom properties `--skdx-popover-available-width` /
- * `-available-height` / `-trigger-width` / `-transform-origin`, so the panel
- * can be sized and animated from CSS without measuring anything by hand.
- * Contains the page according to the root's `modal`: `'trap-focus'` traps Tab
- * inside the panel and marks the rest of the document `inert`, `true` adds the
- * body-scroll lock on top of that, and `false` (the default) does neither.
- * Closes on Escape (returning focus
- * to the trigger) or on an outside interaction: pointer-down outside or focus
- * moving outside, each reported to `onPointerDownOutside`/`onFocusOutside`
- * and, just before them and with the same event, to `onInteractOutside`. Any
- * of those (or `onEscapeKeyDown`) calling `event.preventDefault()` keeps it
- * open. Both focus moves the popover makes on the consumer's behalf are
- * announced first as cancelable `onOpenAutoFocus`/`onCloseAutoFocus` — the
- * latter also covers the manual return to the trigger a non-modal popover
- * does on Escape, where there is no trap to do it — and can be aimed with
- * `initialFocus`/`finalFocus` without a handler at all. Mounts only while open
- * unless `forceMount` is set.
+ * The popover's floating panel: `role="dialog"`, positioned against the trigger via the shared popper layer, that traps or blocks outside interaction according to `modal`.
  *
  * @example
  * ```tsx
@@ -43,4 +14,7 @@ import type { PopoverContentProps } from './types.cjs';
  * </PopoverPortal>
  * ```
  */
-export declare const PopoverContent: React.ForwardRefExoticComponent<Omit<PopoverContentProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const PopoverContent: {
+    ({ forceMount, onEscapeKeyDown, onPointerDownOutside, onFocusOutside, onInteractOutside, onOpenAutoFocus, onCloseAutoFocus, sideOffset, arrowPadding, initialFocus, finalFocus, ref: forwardedRef, ...props }: PopoverContentProps): React.ReactNode;
+    displayName: string;
+};

package/dist/popover/PopoverContent.d.ts

@@ -1,36 +1,7 @@
 import * as React from 'react';
 import type { PopoverContentProps } from './types.js';
 /**
- * The popover's floating panel: `role="dialog"` with `data-state`
- * (`open`/`closed`), named by `PopoverTitle` and described by
- * `PopoverDescription` through `aria-labelledby`/`aria-describedby` — each
- * emitted only while that part is mounted, so an omitted part leaves no
- * reference behind rather than one pointing at nothing. Positioned via the
- * shared popper layer against the
- * trigger (or `PopoverAnchor`) using `side`/`align`/`sideOffset` (defaults
- * to `4`, overriding the popper default of `0`)/`alignOffset` and flipping/
- * shifting to avoid viewport collisions unless `avoidCollisions` is `false`.
- * `arrowPadding` keeps the arrow clear of the panel's rounded corners, and
- * `hideWhenDetached` hides the panel — without closing or unmounting it — while
- * its anchor is scrolled out of view inside a clipping ancestor.
- * Also exposes `data-side`/`data-align` reflecting the resolved placement, and
- * the measurement custom properties `--skdx-popover-available-width` /
- * `-available-height` / `-trigger-width` / `-transform-origin`, so the panel
- * can be sized and animated from CSS without measuring anything by hand.
- * Contains the page according to the root's `modal`: `'trap-focus'` traps Tab
- * inside the panel and marks the rest of the document `inert`, `true` adds the
- * body-scroll lock on top of that, and `false` (the default) does neither.
- * Closes on Escape (returning focus
- * to the trigger) or on an outside interaction: pointer-down outside or focus
- * moving outside, each reported to `onPointerDownOutside`/`onFocusOutside`
- * and, just before them and with the same event, to `onInteractOutside`. Any
- * of those (or `onEscapeKeyDown`) calling `event.preventDefault()` keeps it
- * open. Both focus moves the popover makes on the consumer's behalf are
- * announced first as cancelable `onOpenAutoFocus`/`onCloseAutoFocus` — the
- * latter also covers the manual return to the trigger a non-modal popover
- * does on Escape, where there is no trap to do it — and can be aimed with
- * `initialFocus`/`finalFocus` without a handler at all. Mounts only while open
- * unless `forceMount` is set.
+ * The popover's floating panel: `role="dialog"`, positioned against the trigger via the shared popper layer, that traps or blocks outside interaction according to `modal`.
  *
  * @example
  * ```tsx
@@ -43,4 +14,7 @@ import type { PopoverContentProps } from './types.js';
  * </PopoverPortal>
  * ```
  */
-export declare const PopoverContent: React.ForwardRefExoticComponent<Omit<PopoverContentProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const PopoverContent: {
+    ({ forceMount, onEscapeKeyDown, onPointerDownOutside, onFocusOutside, onInteractOutside, onOpenAutoFocus, onCloseAutoFocus, sideOffset, arrowPadding, initialFocus, finalFocus, ref: forwardedRef, ...props }: PopoverContentProps): React.ReactNode;
+    displayName: string;
+};

package/dist/popover/PopoverDescription.d.cts

@@ -1,11 +1,7 @@
 import * as React from 'react';
 import type { PopoverDescriptionProps } from './types.cjs';
 /**
- * The popover's accessible description: a `<p>` with an id that
- * `PopoverContent` points to via `aria-describedby` while mounted. Optional
- * (unlike `PopoverTitle` — a panel needs a name but may not need description),
- * but the wiring is required: the attribute appears only while this element
- * does, avoiding dangling references.
+ * The popover's accessible description: a `<p>` whose id `PopoverContent` points to via `aria-describedby` while mounted.
  *
  * @example
  * ```tsx
@@ -15,4 +11,7 @@ import type { PopoverDescriptionProps } from './types.cjs';
  * </PopoverContent>
  * ```
  */
-export declare const PopoverDescription: React.ForwardRefExoticComponent<Omit<PopoverDescriptionProps, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
+export declare const PopoverDescription: {
+    ({ ref: forwardedRef, ...props }: PopoverDescriptionProps): React.ReactNode;
+    displayName: string;
+};

package/dist/popover/PopoverDescription.d.ts

@@ -1,11 +1,7 @@
 import * as React from 'react';
 import type { PopoverDescriptionProps } from './types.js';
 /**
- * The popover's accessible description: a `<p>` with an id that
- * `PopoverContent` points to via `aria-describedby` while mounted. Optional
- * (unlike `PopoverTitle` — a panel needs a name but may not need description),
- * but the wiring is required: the attribute appears only while this element
- * does, avoiding dangling references.
+ * The popover's accessible description: a `<p>` whose id `PopoverContent` points to via `aria-describedby` while mounted.
  *
  * @example
  * ```tsx
@@ -15,4 +11,7 @@ import type { PopoverDescriptionProps } from './types.js';
  * </PopoverContent>
  * ```
  */
-export declare const PopoverDescription: React.ForwardRefExoticComponent<Omit<PopoverDescriptionProps, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
+export declare const PopoverDescription: {
+    ({ ref: forwardedRef, ...props }: PopoverDescriptionProps): React.ReactNode;
+    displayName: string;
+};

package/dist/popover/PopoverPortal.d.cts

@@ -1,7 +1,7 @@
+import type { JSX } from 'react';
 import type { PopoverPortalProps } from './types.cjs';
 /**
- * Teleports content to `document.body` or custom `container` to escape
- * clipping ancestors. Mounts only while open unless `forceMount` is set.
+ * Teleports content to `document.body` or a custom `container`, mounting only while open unless `forceMount` is set.
  *
  * @example
  * ```tsx
@@ -11,6 +11,6 @@ import type { PopoverPortalProps } from './types.cjs';
  * ```
  */
 export declare const PopoverPortal: {
-    ({ forceMount, children, ...props }: PopoverPortalProps): import("react").JSX.Element | null;
+    ({ forceMount, children, ...props }: PopoverPortalProps): JSX.Element | null;
     displayName: string;
 };

package/dist/popover/PopoverPortal.d.ts

@@ -1,7 +1,7 @@
+import type { JSX } from 'react';
 import type { PopoverPortalProps } from './types.js';
 /**
- * Teleports content to `document.body` or custom `container` to escape
- * clipping ancestors. Mounts only while open unless `forceMount` is set.
+ * Teleports content to `document.body` or a custom `container`, mounting only while open unless `forceMount` is set.
  *
  * @example
  * ```tsx
@@ -11,6 +11,6 @@ import type { PopoverPortalProps } from './types.js';
  * ```
  */
 export declare const PopoverPortal: {
-    ({ forceMount, children, ...props }: PopoverPortalProps): import("react").JSX.Element | null;
+    ({ forceMount, children, ...props }: PopoverPortalProps): JSX.Element | null;
     displayName: string;
 };

package/dist/popover/PopoverProvider.d.cts

@@ -0,0 +1,20 @@
+import * as React from 'react';
+import type { PopoverProviderContextValue, PopoverProviderProps } from './types.cjs';
+export declare const PopoverProviderContext: React.FC<PopoverProviderContextValue & {
+    children: React.ReactNode;
+}>, usePopoverProviderContext: (consumerName: string) => PopoverProviderContextValue;
+/**
+ * Coordinates hover-delay timing across the `role="tooltip"` popovers beneath it: after any of them closes, siblings open instantly for `skipDelayDuration` ms, like OS tooltips.
+ *
+ * @example
+ * ```tsx
+ * <PopoverProvider delayDuration={500}>
+ *   <Popover role="tooltip" openOn="hover" trigger={<button>A</button>}>Tooltip A</Popover>
+ *   <Popover role="tooltip" openOn="hover" trigger={<button>B</button>}>Tooltip B</Popover>
+ * </PopoverProvider>
+ * ```
+ */
+export declare function PopoverProvider({ children, delayDuration, skipDelayDuration, closeDelay, disableHoverableContent, }: PopoverProviderProps): React.JSX.Element;
+export declare namespace PopoverProvider {
+    var displayName: string;
+}

package/dist/popover/PopoverProvider.d.ts

@@ -0,0 +1,20 @@
+import * as React from 'react';
+import type { PopoverProviderContextValue, PopoverProviderProps } from './types.js';
+export declare const PopoverProviderContext: React.FC<PopoverProviderContextValue & {
+    children: React.ReactNode;
+}>, usePopoverProviderContext: (consumerName: string) => PopoverProviderContextValue;
+/**
+ * Coordinates hover-delay timing across the `role="tooltip"` popovers beneath it: after any of them closes, siblings open instantly for `skipDelayDuration` ms, like OS tooltips.
+ *
+ * @example
+ * ```tsx
+ * <PopoverProvider delayDuration={500}>
+ *   <Popover role="tooltip" openOn="hover" trigger={<button>A</button>}>Tooltip A</Popover>
+ *   <Popover role="tooltip" openOn="hover" trigger={<button>B</button>}>Tooltip B</Popover>
+ * </PopoverProvider>
+ * ```
+ */
+export declare function PopoverProvider({ children, delayDuration, skipDelayDuration, closeDelay, disableHoverableContent, }: PopoverProviderProps): React.JSX.Element;
+export declare namespace PopoverProvider {
+    var displayName: string;
+}

package/dist/popover/PopoverTitle.d.cts

@@ -1,10 +1,7 @@
 import * as React from 'react';
 import type { PopoverTitleProps } from './types.cjs';
 /**
- * The popover's accessible name: an `<h2>` whose id `PopoverContent` points to
- * via `aria-labelledby` while mounted. Without it, `role="dialog"` announces as
- * bare "dialog" (useless when multiple are on a page), forcing consumers to add
- * `aria-label`. A visible Title names it correctly by construction.
+ * The popover's accessible name: an `<h2>` whose id `PopoverContent` points to via `aria-labelledby` while mounted.
  *
  * @example
  * ```tsx
@@ -14,4 +11,7 @@ import type { PopoverTitleProps } from './types.cjs';
  * </PopoverContent>
  * ```
  */
-export declare const PopoverTitle: React.ForwardRefExoticComponent<Omit<PopoverTitleProps, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
+export declare const PopoverTitle: {
+    ({ ref: forwardedRef, ...props }: PopoverTitleProps): React.ReactNode;
+    displayName: string;
+};

package/dist/popover/PopoverTitle.d.ts

@@ -1,10 +1,7 @@
 import * as React from 'react';
 import type { PopoverTitleProps } from './types.js';
 /**
- * The popover's accessible name: an `<h2>` whose id `PopoverContent` points to
- * via `aria-labelledby` while mounted. Without it, `role="dialog"` announces as
- * bare "dialog" (useless when multiple are on a page), forcing consumers to add
- * `aria-label`. A visible Title names it correctly by construction.
+ * The popover's accessible name: an `<h2>` whose id `PopoverContent` points to via `aria-labelledby` while mounted.
  *
  * @example
  * ```tsx
@@ -14,4 +11,7 @@ import type { PopoverTitleProps } from './types.js';
  * </PopoverContent>
  * ```
  */
-export declare const PopoverTitle: React.ForwardRefExoticComponent<Omit<PopoverTitleProps, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
+export declare const PopoverTitle: {
+    ({ ref: forwardedRef, ...props }: PopoverTitleProps): React.ReactNode;
+    displayName: string;
+};