@yahoo/uds 3.175.1 → 3.176.0-beta.1

package/dist/components/client/Menu/Menu.ItemCheckbox.d.cts

@@ -131,6 +131,6 @@ interface MenuItemCheckboxProps extends Omit<PressableProps, 'asChild'>, HtmlBut
  *
  * @related [Menu](https://uds.build/docs/components/menu), [Menu.Item](https://uds.build/docs/components/menu-item)
  **/
-declare const MenuItemCheckbox: _$react.ForwardRefExoticComponent<Omit<MenuItemCheckboxProps, "active" | "hideEndIcon" | "rootProps"> & _$react.RefAttributes<HTMLDivElement>>;
+declare const MenuItemCheckbox: _$react.ForwardRefExoticComponent<Omit<MenuItemCheckboxProps, "hideEndIcon" | "rootProps" | "active"> & _$react.RefAttributes<HTMLDivElement>>;
 //#endregion
 export { MenuItemCheckbox, type MenuItemCheckboxProps };

package/dist/components/client/Menu/Menu.ItemCheckbox.d.ts

@@ -132,6 +132,6 @@ interface MenuItemCheckboxProps extends Omit<PressableProps, 'asChild'>, HtmlBut
  *
  * @related [Menu](https://uds.build/docs/components/menu), [Menu.Item](https://uds.build/docs/components/menu-item)
  **/
-declare const MenuItemCheckbox: _$react.ForwardRefExoticComponent<Omit<MenuItemCheckboxProps, "active" | "hideEndIcon" | "rootProps"> & _$react.RefAttributes<HTMLDivElement>>;
+declare const MenuItemCheckbox: _$react.ForwardRefExoticComponent<Omit<MenuItemCheckboxProps, "hideEndIcon" | "rootProps" | "active"> & _$react.RefAttributes<HTMLDivElement>>;
 //#endregion
 export { MenuItemCheckbox, type MenuItemCheckboxProps };

package/dist/components/client/Popover/Popover.cjs

@@ -9,6 +9,10 @@ let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 let _ariakit_react = require("@ariakit/react");
 //#region src/components/client/Popover/Popover.tsx
+function resolveAnchor(anchor) {
+	if (!anchor) return null;
+	return anchor instanceof HTMLElement ? anchor : anchor.current;
+}
 const POPOVER_OPEN_EVENT = "uds:popover-open";
 /**
 * **⚙️️ A Popover component that anchors to a trigger element
@@ -37,7 +41,7 @@ const POPOVER_OPEN_EVENT = "uds:popover-open";
 *
 * @related [Toast](https://uds.build/docs/components/toast), [Tooltip](https://uds.build/docs/components/tooltip)
 **/
-function Popover({ children, placement, open, defaultOpen = false, portal = true, hideArrow = false, hideDismissButton = false, onClose, onOpen, reduceMotion: forceReduceMotion = false, disableAutoFocus = false, disableVerticalSpacing = false, disableHorizontalSpacing = false, sameWidth = false, gutter = 4, unmountOnHide = false }) {
+function Popover({ children, placement, anchor, open, defaultOpen = false, portal = true, hideArrow = false, hideDismissButton = false, onClose, onOpen, reduceMotion: forceReduceMotion = false, disableAutoFocus = false, disableVerticalSpacing = false, disableHorizontalSpacing = false, sameWidth = false, gutter = 4, unmountOnHide = false }) {
 	const controlledProps = open !== void 0 ? {
 		showTimeout: 0,
 		hideTimeout: 0,
@@ -47,6 +51,17 @@ function Popover({ children, placement, open, defaultOpen = false, portal = true
 	const { animationDuration: animationDurationConfig, ariaKitPlacement } = require_components_client_Popover_UDSPopoverConfigProvider.usePopoverConfig(void 0, void 0, { placement });
 	const id = (0, react.useId)();
 	const store = (0, _ariakit_react.usePopoverStore)({ defaultOpen });
+	(0, react.useLayoutEffect)(() => {
+		if (anchor === void 0) return;
+		const element = resolveAnchor(anchor);
+		store.setAnchorElement(element);
+		store.setDisclosureElement(element);
+		store.render();
+	}, [
+		store,
+		anchor,
+		open
+	]);
 	const handleSetOpen = (0, react.useCallback)((newOpen) => {
 		if (newOpen) {
 			onOpen?.();
@@ -77,7 +92,8 @@ function Popover({ children, placement, open, defaultOpen = false, portal = true
 			disableHorizontalSpacing,
 			sameWidth,
 			gutter,
-			unmountOnHide
+			unmountOnHide,
+			hasAnchor: anchor !== void 0
 		},
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_ariakit_react.PopoverProvider, {
 			placement: ariaKitPlacement,

package/dist/components/client/Popover/Popover.d.cts

@@ -1,9 +1,20 @@
 
 import { UniversalPopoverProps } from "../../../types/dist/index.cjs";
+import { RefObject } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/components/client/Popover/Popover.d.ts
-type PopoverProps = UniversalPopoverProps;
+/** An element (or ref to one) that the popover points at without modifying it. */
+type PopoverAnchorTarget = HTMLElement | RefObject<HTMLElement | null> | null;
+interface PopoverProps extends UniversalPopoverProps {
+  /**
+   * Anchors the popover to an element the consumer doesn't render (e.g. for
+   * onboarding cues). Only the element's position is read — no attributes,
+   * roles, or handlers are applied to it. When set, omit `PopoverTrigger` and
+   * control visibility with the `open` prop.
+   */
+  anchor?: PopoverAnchorTarget;
+}
 /**
  * **⚙️️ A Popover component that anchors to a trigger element
  *
@@ -34,6 +45,7 @@ type PopoverProps = UniversalPopoverProps;
 declare function Popover({
   children,
   placement,
+  anchor,
   open,
   defaultOpen,
   portal,
@@ -53,4 +65,4 @@ declare namespace Popover {
   var displayName: string;
 }
 //#endregion
-export { Popover };
+export { Popover, type PopoverAnchorTarget, type PopoverProps };

package/dist/components/client/Popover/Popover.d.ts

@@ -1,10 +1,21 @@
 
 "use client";
 import { UniversalPopoverProps } from "../../../types/dist/index.js";
+import { RefObject } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/components/client/Popover/Popover.d.ts
-type PopoverProps = UniversalPopoverProps;
+/** An element (or ref to one) that the popover points at without modifying it. */
+type PopoverAnchorTarget = HTMLElement | RefObject<HTMLElement | null> | null;
+interface PopoverProps extends UniversalPopoverProps {
+  /**
+   * Anchors the popover to an element the consumer doesn't render (e.g. for
+   * onboarding cues). Only the element's position is read — no attributes,
+   * roles, or handlers are applied to it. When set, omit `PopoverTrigger` and
+   * control visibility with the `open` prop.
+   */
+  anchor?: PopoverAnchorTarget;
+}
 /**
  * **⚙️️ A Popover component that anchors to a trigger element
  *
@@ -35,6 +46,7 @@ type PopoverProps = UniversalPopoverProps;
 declare function Popover({
   children,
   placement,
+  anchor,
   open,
   defaultOpen,
   portal,
@@ -54,4 +66,4 @@ declare namespace Popover {
   var displayName: string;
 }
 //#endregion
-export { Popover };
+export { Popover, type PopoverAnchorTarget, type PopoverProps };

package/dist/components/client/Popover/Popover.js

@@ -3,10 +3,14 @@
 import { usePrefersReducedMotion } from "../../../hooks/usePrefersReducedMotion.js";
 import { PopoverInternalContext } from "./PopoverContext.js";
 import { usePopoverConfig } from "./UDSPopoverConfigProvider.js";
-import { useCallback, useEffect, useId } from "react";
+import { useCallback, useEffect, useId, useLayoutEffect } from "react";
 import { jsx } from "react/jsx-runtime";
 import { PopoverProvider, usePopoverStore } from "@ariakit/react";
 //#region src/components/client/Popover/Popover.tsx
+function resolveAnchor(anchor) {
+	if (!anchor) return null;
+	return anchor instanceof HTMLElement ? anchor : anchor.current;
+}
 const POPOVER_OPEN_EVENT = "uds:popover-open";
 /**
 * **⚙️️ A Popover component that anchors to a trigger element
@@ -35,7 +39,7 @@ const POPOVER_OPEN_EVENT = "uds:popover-open";
 *
 * @related [Toast](https://uds.build/docs/components/toast), [Tooltip](https://uds.build/docs/components/tooltip)
 **/
-function Popover({ children, placement, open, defaultOpen = false, portal = true, hideArrow = false, hideDismissButton = false, onClose, onOpen, reduceMotion: forceReduceMotion = false, disableAutoFocus = false, disableVerticalSpacing = false, disableHorizontalSpacing = false, sameWidth = false, gutter = 4, unmountOnHide = false }) {
+function Popover({ children, placement, anchor, open, defaultOpen = false, portal = true, hideArrow = false, hideDismissButton = false, onClose, onOpen, reduceMotion: forceReduceMotion = false, disableAutoFocus = false, disableVerticalSpacing = false, disableHorizontalSpacing = false, sameWidth = false, gutter = 4, unmountOnHide = false }) {
 	const controlledProps = open !== void 0 ? {
 		showTimeout: 0,
 		hideTimeout: 0,
@@ -45,6 +49,17 @@ function Popover({ children, placement, open, defaultOpen = false, portal = true
 	const { animationDuration: animationDurationConfig, ariaKitPlacement } = usePopoverConfig(void 0, void 0, { placement });
 	const id = useId();
 	const store = usePopoverStore({ defaultOpen });
+	useLayoutEffect(() => {
+		if (anchor === void 0) return;
+		const element = resolveAnchor(anchor);
+		store.setAnchorElement(element);
+		store.setDisclosureElement(element);
+		store.render();
+	}, [
+		store,
+		anchor,
+		open
+	]);
 	const handleSetOpen = useCallback((newOpen) => {
 		if (newOpen) {
 			onOpen?.();
@@ -75,7 +90,8 @@ function Popover({ children, placement, open, defaultOpen = false, portal = true
 			disableHorizontalSpacing,
 			sameWidth,
 			gutter,
-			unmountOnHide
+			unmountOnHide,
+			hasAnchor: anchor !== void 0
 		},
 		children: /* @__PURE__ */ jsx(PopoverProvider, {
 			placement: ariaKitPlacement,

package/dist/components/client/Popover/PopoverAnchor.cjs

@@ -0,0 +1,42 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../../_virtual/_rolldown/runtime.cjs");
+let react = require("react");
+let react_jsx_runtime = require("react/jsx-runtime");
+let _ariakit_react = require("@ariakit/react");
+//#region src/components/client/Popover/PopoverAnchor.tsx
+/**
+* **⚙️️ Designates a consumer-rendered element as the popover's positioning anchor**
+*
+* @componentType Client component
+*
+* @description
+* Unlike `PopoverTrigger`, `PopoverAnchor` only marks what the popover points at —
+* it does not open the popover and writes no disclosure semantics to the element.
+* Use it with a controlled `open` on `Popover` when the anchor is already
+* interactive (or shouldn't be), e.g. onboarding cues pointing at existing UI.
+*
+* @example
+* ```tsx
+* 'use client';
+* import { Popover, PopoverAnchor, PopoverContent } from "@yahoo/uds";
+*
+* <Popover open={showCue} onClose={dismissCue}>
+*   <PopoverAnchor>
+*     <a href="/folders/trash">Trash</a>
+*   </PopoverAnchor>
+*   <PopoverContent aria-label="Onboarding tip">Tip content</PopoverContent>
+* </Popover>
+* ```
+**/
+function PopoverAnchor({ children }) {
+	if ((0, react.isValidElement)(children) && children.type !== react.Fragment) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_ariakit_react.PopoverAnchor, { render: children });
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_ariakit_react.PopoverAnchor, {
+		className: "inline",
+		children
+	});
+}
+PopoverAnchor.displayName = "PopoverAnchor";
+//#endregion
+exports.PopoverAnchor = PopoverAnchor;

package/dist/components/client/Popover/PopoverAnchor.d.cts

@@ -0,0 +1,41 @@
+
+import { ReactNode } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/client/Popover/PopoverAnchor.d.ts
+interface PopoverAnchorProps {
+  /** The element the popover points at. Only its position is used — no disclosure semantics (role, tabindex, aria-*) are applied. */
+  children: ReactNode;
+}
+/**
+ * **⚙️️ Designates a consumer-rendered element as the popover's positioning anchor**
+ *
+ * @componentType Client component
+ *
+ * @description
+ * Unlike `PopoverTrigger`, `PopoverAnchor` only marks what the popover points at —
+ * it does not open the popover and writes no disclosure semantics to the element.
+ * Use it with a controlled `open` on `Popover` when the anchor is already
+ * interactive (or shouldn't be), e.g. onboarding cues pointing at existing UI.
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ * import { Popover, PopoverAnchor, PopoverContent } from "@yahoo/uds";
+ *
+ * <Popover open={showCue} onClose={dismissCue}>
+ *   <PopoverAnchor>
+ *     <a href="/folders/trash">Trash</a>
+ *   </PopoverAnchor>
+ *   <PopoverContent aria-label="Onboarding tip">Tip content</PopoverContent>
+ * </Popover>
+ * ```
+ **/
+declare function PopoverAnchor({
+  children
+}: PopoverAnchorProps): _$react_jsx_runtime0.JSX.Element;
+declare namespace PopoverAnchor {
+  var displayName: string;
+}
+//#endregion
+export { PopoverAnchor, type PopoverAnchorProps };

package/dist/components/client/Popover/PopoverAnchor.d.ts

@@ -0,0 +1,42 @@
+
+"use client";
+import { ReactNode } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/client/Popover/PopoverAnchor.d.ts
+interface PopoverAnchorProps {
+  /** The element the popover points at. Only its position is used — no disclosure semantics (role, tabindex, aria-*) are applied. */
+  children: ReactNode;
+}
+/**
+ * **⚙️️ Designates a consumer-rendered element as the popover's positioning anchor**
+ *
+ * @componentType Client component
+ *
+ * @description
+ * Unlike `PopoverTrigger`, `PopoverAnchor` only marks what the popover points at —
+ * it does not open the popover and writes no disclosure semantics to the element.
+ * Use it with a controlled `open` on `Popover` when the anchor is already
+ * interactive (or shouldn't be), e.g. onboarding cues pointing at existing UI.
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ * import { Popover, PopoverAnchor, PopoverContent } from "@yahoo/uds";
+ *
+ * <Popover open={showCue} onClose={dismissCue}>
+ *   <PopoverAnchor>
+ *     <a href="/folders/trash">Trash</a>
+ *   </PopoverAnchor>
+ *   <PopoverContent aria-label="Onboarding tip">Tip content</PopoverContent>
+ * </Popover>
+ * ```
+ **/
+declare function PopoverAnchor({
+  children
+}: PopoverAnchorProps): _$react_jsx_runtime0.JSX.Element;
+declare namespace PopoverAnchor {
+  var displayName: string;
+}
+//#endregion
+export { PopoverAnchor, type PopoverAnchorProps };

package/dist/components/client/Popover/PopoverAnchor.js

@@ -0,0 +1,40 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+import { Fragment, isValidElement } from "react";
+import { jsx } from "react/jsx-runtime";
+import { PopoverAnchor as PopoverAnchor$1 } from "@ariakit/react";
+//#region src/components/client/Popover/PopoverAnchor.tsx
+/**
+* **⚙️️ Designates a consumer-rendered element as the popover's positioning anchor**
+*
+* @componentType Client component
+*
+* @description
+* Unlike `PopoverTrigger`, `PopoverAnchor` only marks what the popover points at —
+* it does not open the popover and writes no disclosure semantics to the element.
+* Use it with a controlled `open` on `Popover` when the anchor is already
+* interactive (or shouldn't be), e.g. onboarding cues pointing at existing UI.
+*
+* @example
+* ```tsx
+* 'use client';
+* import { Popover, PopoverAnchor, PopoverContent } from "@yahoo/uds";
+*
+* <Popover open={showCue} onClose={dismissCue}>
+*   <PopoverAnchor>
+*     <a href="/folders/trash">Trash</a>
+*   </PopoverAnchor>
+*   <PopoverContent aria-label="Onboarding tip">Tip content</PopoverContent>
+* </Popover>
+* ```
+**/
+function PopoverAnchor({ children }) {
+	if (isValidElement(children) && children.type !== Fragment) return /* @__PURE__ */ jsx(PopoverAnchor$1, { render: children });
+	return /* @__PURE__ */ jsx(PopoverAnchor$1, {
+		className: "inline",
+		children
+	});
+}
+PopoverAnchor.displayName = "PopoverAnchor";
+//#endregion
+export { PopoverAnchor };

package/dist/components/client/Popover/PopoverContent.cjs

@@ -21,7 +21,7 @@ let _ariakit_react = require("@ariakit/react");
 const ARROW_HEIGHT = 12;
 const ARROW_WIDTH = 22;
 const ARROW_TIP_RADIUS_FRACTION = .3;
-const PopoverContent = (0, react.forwardRef)(function PopoverContent({ children, className, closeIcon = _yahoo_uds_icons.Cross, slotProps, maxWidth, maxHeight }, ref) {
+const PopoverContent = (0, react.forwardRef)(function PopoverContent({ children, className, closeIcon = _yahoo_uds_icons.Cross, slotProps, maxWidth, maxHeight, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy }, ref) {
 	const store = (0, _ariakit_react.usePopoverContext)();
 	const open = (0, _ariakit_react.useStoreState)(store, "open");
 	const internalContext = (0, react.useContext)(require_components_client_Popover_PopoverContext.PopoverInternalContext);
@@ -104,6 +104,8 @@ const PopoverContent = (0, react.forwardRef)(function PopoverContent({ children,
 		ref: mergedRef,
 		className: classNames.root,
 		unmountOnHide: internalContext?.unmountOnHide,
+		"aria-label": ariaLabel,
+		"aria-labelledby": ariaLabelledBy,
 		...slotProps?.root,
 		portal: internalContext ? internalContext.portal : true,
 		gutter: internalContext?.hideArrow ? gutter : ARROW_HEIGHT + gutter,

package/dist/components/client/Popover/PopoverContent.d.cts

@@ -9,6 +9,10 @@ type DataAttributes = {
   [name: `data-${string}`]: string;
 };
 interface PopoverContentProps extends UniversalPopoverContentProps {
+  /** Accessible name for the popover dialog. Required when no visible heading is referenced via `aria-labelledby`. */
+  'aria-label'?: string;
+  /** ID of the element that labels the popover dialog. */
+  'aria-labelledby'?: string;
   slotProps?: {
     root?: Partial<React.HTMLAttributes<HTMLDivElement> & DataAttributes>;
     content?: Partial<React.HTMLAttributes<HTMLDivElement> & DataAttributes>;
@@ -25,4 +29,4 @@ interface PopoverContentProps extends UniversalPopoverContentProps {
 }
 declare const PopoverContent: _$react.ForwardRefExoticComponent<PopoverContentProps & _$react.RefAttributes<HTMLInputElement>>;
 //#endregion
-export { PopoverContent };
+export { PopoverContent, type PopoverContentProps };

package/dist/components/client/Popover/PopoverContent.d.ts

@@ -10,6 +10,10 @@ type DataAttributes = {
   [name: `data-${string}`]: string;
 };
 interface PopoverContentProps extends UniversalPopoverContentProps {
+  /** Accessible name for the popover dialog. Required when no visible heading is referenced via `aria-labelledby`. */
+  'aria-label'?: string;
+  /** ID of the element that labels the popover dialog. */
+  'aria-labelledby'?: string;
   slotProps?: {
     root?: Partial<React.HTMLAttributes<HTMLDivElement> & DataAttributes>;
     content?: Partial<React.HTMLAttributes<HTMLDivElement> & DataAttributes>;
@@ -26,4 +30,4 @@ interface PopoverContentProps extends UniversalPopoverContentProps {
 }
 declare const PopoverContent: _$react.ForwardRefExoticComponent<PopoverContentProps & _$react.RefAttributes<HTMLInputElement>>;
 //#endregion
-export { PopoverContent };
+export { PopoverContent, type PopoverContentProps };

package/dist/components/client/Popover/PopoverContent.js

@@ -19,7 +19,7 @@ import { Popover, PopoverArrow, PopoverDismiss, usePopoverContext, useStoreState
 const ARROW_HEIGHT = 12;
 const ARROW_WIDTH = 22;
 const ARROW_TIP_RADIUS_FRACTION = .3;
-const PopoverContent = forwardRef(function PopoverContent({ children, className, closeIcon = Cross, slotProps, maxWidth, maxHeight }, ref) {
+const PopoverContent = forwardRef(function PopoverContent({ children, className, closeIcon = Cross, slotProps, maxWidth, maxHeight, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy }, ref) {
 	const store = usePopoverContext();
 	const open = useStoreState(store, "open");
 	const internalContext = useContext(PopoverInternalContext);
@@ -102,6 +102,8 @@ const PopoverContent = forwardRef(function PopoverContent({ children, className,
 		ref: mergedRef,
 		className: classNames.root,
 		unmountOnHide: internalContext?.unmountOnHide,
+		"aria-label": ariaLabel,
+		"aria-labelledby": ariaLabelledBy,
 		...slotProps?.root,
 		portal: internalContext ? internalContext.portal : true,
 		gutter: internalContext?.hideArrow ? gutter : ARROW_HEIGHT + gutter,

package/dist/components/client/Popover/PopoverContext.d.cts

@@ -16,6 +16,7 @@ interface PopoverInternalContextType {
   sameWidth: boolean;
   gutter: number;
   unmountOnHide: boolean;
+  hasAnchor: boolean;
 }
 declare const PopoverInternalContext: _$react.Context<PopoverInternalContextType | null>;
 //#endregion

package/dist/components/client/Popover/PopoverContext.d.ts

@@ -17,6 +17,7 @@ interface PopoverInternalContextType {
   sameWidth: boolean;
   gutter: number;
   unmountOnHide: boolean;
+  hasAnchor: boolean;
 }
 declare const PopoverInternalContext: _$react.Context<PopoverInternalContextType | null>;
 //#endregion

package/dist/components/client/Popover/PopoverTrigger.cjs

@@ -11,6 +11,10 @@ function PopoverTrigger({ children }) {
 	const internalContext = (0, react.useContext)(require_components_client_Popover_PopoverContext.PopoverInternalContext);
 	const open = (0, _ariakit_react.useStoreState)((0, _ariakit_react.usePopoverContext)(), "open");
 	const toggleOnClick = !internalContext?.isControlled;
+	const hasAnchor = internalContext?.hasAnchor ?? false;
+	(0, react.useEffect)(() => {
+		if (process.env.NODE_ENV !== "production" && hasAnchor) console.warn("UDS Popover: `PopoverTrigger` is ignored for positioning when the `anchor` prop is set on `Popover`. Remove one of them.");
+	}, [hasAnchor]);
 	const handleClick = (event) => {
 		if (internalContext?.isControlled && open) internalContext.onClose?.(event.nativeEvent);
 	};

package/dist/components/client/Popover/PopoverTrigger.js

@@ -1,7 +1,7 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 "use client";
 import { PopoverInternalContext } from "./PopoverContext.js";
-import { Fragment, isValidElement, useContext } from "react";
+import { Fragment, isValidElement, useContext, useEffect } from "react";
 import { jsx } from "react/jsx-runtime";
 import { PopoverDisclosure, usePopoverContext, useStoreState } from "@ariakit/react";
 //#region src/components/client/Popover/PopoverTrigger.tsx
@@ -9,6 +9,10 @@ function PopoverTrigger({ children }) {
 	const internalContext = useContext(PopoverInternalContext);
 	const open = useStoreState(usePopoverContext(), "open");
 	const toggleOnClick = !internalContext?.isControlled;
+	const hasAnchor = internalContext?.hasAnchor ?? false;
+	useEffect(() => {
+		if (process.env.NODE_ENV !== "production" && hasAnchor) console.warn("UDS Popover: `PopoverTrigger` is ignored for positioning when the `anchor` prop is set on `Popover`. Remove one of them.");
+	}, [hasAnchor]);
 	const handleClick = (event) => {
 		if (internalContext?.isControlled && open) internalContext.onClose?.(event.nativeEvent);
 	};

package/dist/components/client/Popover/index.cjs

@@ -3,9 +3,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_components_client_Popover_UDSPopoverConfigProvider = require("./UDSPopoverConfigProvider.cjs");
 const require_components_client_Popover_Popover = require("./Popover.cjs");
+const require_components_client_Popover_PopoverAnchor = require("./PopoverAnchor.cjs");
 const require_components_client_Popover_PopoverContent = require("./PopoverContent.cjs");
 const require_components_client_Popover_PopoverTrigger = require("./PopoverTrigger.cjs");
 exports.Popover = require_components_client_Popover_Popover.Popover;
+exports.PopoverAnchor = require_components_client_Popover_PopoverAnchor.PopoverAnchor;
 exports.PopoverContent = require_components_client_Popover_PopoverContent.PopoverContent;
 exports.PopoverTrigger = require_components_client_Popover_PopoverTrigger.PopoverTrigger;
 exports.UDSPopoverConfigProvider = require_components_client_Popover_UDSPopoverConfigProvider.UDSPopoverConfigProvider;

package/dist/components/client/Popover/index.d.cts

@@ -1,7 +1,8 @@
 
-import { UniversalPopoverContentProps, UniversalPopoverProps, UniversalPopoverTriggerProps } from "../../../types/dist/index.cjs";
-import { Popover } from "./Popover.cjs";
-import { PopoverContent } from "./PopoverContent.cjs";
+import { UniversalPopoverTriggerProps } from "../../../types/dist/index.cjs";
+import { Popover, PopoverAnchorTarget, PopoverProps } from "./Popover.cjs";
+import { PopoverAnchor, PopoverAnchorProps } from "./PopoverAnchor.cjs";
+import { PopoverContent, PopoverContentProps } from "./PopoverContent.cjs";
 import { PopoverTrigger } from "./PopoverTrigger.cjs";
 import { UDSPopoverConfigProvider, UDSPopoverConfigProviderProps } from "./UDSPopoverConfigProvider.cjs";
-export { Popover, PopoverContent, type UniversalPopoverContentProps as PopoverContentProps, type UniversalPopoverProps as PopoverProps, PopoverTrigger, type UniversalPopoverTriggerProps as PopoverTriggerProps, UDSPopoverConfigProvider, type UDSPopoverConfigProviderProps };
+export { Popover, PopoverAnchor, PopoverAnchorProps, PopoverAnchorTarget, PopoverContent, PopoverContentProps, PopoverProps, PopoverTrigger, type UniversalPopoverTriggerProps as PopoverTriggerProps, UDSPopoverConfigProvider, type UDSPopoverConfigProviderProps };

package/dist/components/client/Popover/index.d.ts

@@ -1,8 +1,9 @@
 
 "use client";
-import { UniversalPopoverContentProps, UniversalPopoverProps, UniversalPopoverTriggerProps } from "../../../types/dist/index.js";
-import { Popover } from "./Popover.js";
-import { PopoverContent } from "./PopoverContent.js";
+import { UniversalPopoverTriggerProps } from "../../../types/dist/index.js";
+import { Popover, PopoverAnchorTarget, PopoverProps } from "./Popover.js";
+import { PopoverAnchor, PopoverAnchorProps } from "./PopoverAnchor.js";
+import { PopoverContent, PopoverContentProps } from "./PopoverContent.js";
 import { PopoverTrigger } from "./PopoverTrigger.js";
 import { UDSPopoverConfigProvider, UDSPopoverConfigProviderProps } from "./UDSPopoverConfigProvider.js";
-export { Popover, PopoverContent, type UniversalPopoverContentProps as PopoverContentProps, type UniversalPopoverProps as PopoverProps, PopoverTrigger, type UniversalPopoverTriggerProps as PopoverTriggerProps, UDSPopoverConfigProvider, type UDSPopoverConfigProviderProps };
+export { Popover, PopoverAnchor, PopoverAnchorProps, PopoverAnchorTarget, PopoverContent, PopoverContentProps, PopoverProps, PopoverTrigger, type UniversalPopoverTriggerProps as PopoverTriggerProps, UDSPopoverConfigProvider, type UDSPopoverConfigProviderProps };

package/dist/components/client/Popover/index.js

@@ -2,6 +2,7 @@
 "use client";
 import { UDSPopoverConfigProvider } from "./UDSPopoverConfigProvider.js";
 import { Popover } from "./Popover.js";
+import { PopoverAnchor } from "./PopoverAnchor.js";
 import { PopoverContent } from "./PopoverContent.js";
 import { PopoverTrigger } from "./PopoverTrigger.js";
-export { Popover, PopoverContent, PopoverTrigger, UDSPopoverConfigProvider };
+export { Popover, PopoverAnchor, PopoverContent, PopoverTrigger, UDSPopoverConfigProvider };