@yahoo/uds 3.145.0-beta.4 → 3.146.0

package/dist/components/client/PaddleNav/PaddleNav.js

@@ -0,0 +1,191 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+import { cx } from "../../../styles/styler.js";
+import { hasDisplayName } from "../../../utils/hasDisplayName.js";
+import { Box } from "../../Box.js";
+import { useRtl } from "../../../hooks/useRtl.js";
+import { PaddleNavContext, defaultPaddleHiddenByRole } from "./paddleNavContext.js";
+import { PaddleButtonNext } from "./PaddleButtonNext.js";
+import { PaddleButtonPrevious } from "./PaddleButtonPrevious.js";
+import { PaddleNavContent } from "./PaddleNavContent.js";
+import { resolvePaddleNavCornerOrientation } from "./utils/resolvePaddleNavCornerOrientation.js";
+import { Children, forwardRef, isValidElement, useCallback, useMemo, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/components/client/PaddleNav/PaddleNav.tsx
+function isPaddleButtonPrevious(child) {
+	return child.type === PaddleButtonPrevious || hasDisplayName(child, "PaddleButtonPrevious");
+}
+function isPaddleButtonNext(child) {
+	return child.type === PaddleButtonNext || hasDisplayName(child, "PaddleButtonNext");
+}
+function partitionChildren(children) {
+	const contentNodes = [];
+	let previousPaddle;
+	let nextPaddle;
+	const passthroughNodes = [];
+	Children.forEach(children, (child) => {
+		if (!isValidElement(child)) {
+			passthroughNodes.push(child);
+			return;
+		}
+		if (isPaddleButtonPrevious(child)) {
+			if (!previousPaddle) previousPaddle = child;
+			return;
+		}
+		if (isPaddleButtonNext(child)) {
+			if (!nextPaddle) nextPaddle = child;
+			return;
+		}
+		if (child.type === PaddleNavContent || hasDisplayName(child, "PaddleNavContent")) {
+			contentNodes.push(child);
+			return;
+		}
+		passthroughNodes.push(child);
+	});
+	return {
+		contentNodes,
+		previousPaddle,
+		nextPaddle,
+		passthroughNodes
+	};
+}
+function getPaddleWrapperClassName(positionClasses, hidden) {
+	return cx(positionClasses, hidden && "pointer-events-none");
+}
+function getCornerInsetClasses(orientation, outsideContent) {
+	const inside = !outsideContent;
+	switch (orientation) {
+		case "top-left": return inside ? "top-2 left-2" : "-top-12 left-0";
+		case "top-right": return inside ? "top-2 right-2" : "-top-12 right-0";
+		case "bottom-left": return inside ? "bottom-2 left-2" : "-bottom-12 left-0";
+		case "bottom-right": return inside ? "bottom-2 right-2" : "-bottom-12 right-0";
+		default: return "";
+	}
+}
+const horizontalOverlayStartClass = "left-2 top-1/2 -translate-y-1/2";
+const horizontalOverlayEndClass = "right-2 top-1/2 -translate-y-1/2";
+/** Keeps prev/next paddles in [←][→] screen order inside a cluster when an ancestor sets dir="rtl". */
+const paddleClusterClassName = "inline-flex flex-row gap-2 items-center pointer-events-auto";
+const PaddleNav = forwardRef(function PaddleNav({ children, orientation = "horizontal", outsideContent = false, variant = "primary", size = "md", className, ...rest }, ref) {
+	const isRtl = useRtl();
+	const [paddleHiddenByRole, setPaddleHiddenByRole] = useState(defaultPaddleHiddenByRole);
+	const registerPaddleHidden = useCallback((role, hidden) => {
+		setPaddleHiddenByRole((current) => {
+			if (current[role] === hidden) return current;
+			return {
+				...current,
+				[role]: hidden
+			};
+		});
+	}, []);
+	const paddleNavContextValue = useMemo(() => ({
+		orientation,
+		outsideContent,
+		variant,
+		size,
+		paddleHiddenByRole,
+		registerPaddleHidden
+	}), [
+		orientation,
+		outsideContent,
+		variant,
+		size,
+		paddleHiddenByRole,
+		registerPaddleHidden
+	]);
+	const { contentNodes, previousPaddle, nextPaddle, passthroughNodes } = partitionChildren(children);
+	const isVertical = orientation === "vertical";
+	const isHorizontalCenter = orientation === "horizontal";
+	const isCenter = isVertical || isHorizontalCenter;
+	const isCorner = !isCenter;
+	const resolvedOrientation = resolvePaddleNavCornerOrientation(orientation, isCorner ? isRtl : false);
+	const physicalCornerOrientation = isCorner && resolvedOrientation !== "horizontal" && resolvedOrientation !== "vertical" ? resolvedOrientation : void 0;
+	if (!(contentNodes.length > 0)) return /* @__PURE__ */ jsx(PaddleNavContext.Provider, {
+		value: paddleNavContextValue,
+		children: /* @__PURE__ */ jsxs(Box, {
+			ref,
+			dir: isVertical ? void 0 : "ltr",
+			className: cx(paddleClusterClassName, isVertical && "flex-col", className),
+			"data-paddle-nav-orientation": orientation,
+			"data-paddle-nav-outside": outsideContent ? "true" : "false",
+			...rest,
+			children: [
+				previousPaddle,
+				nextPaddle,
+				passthroughNodes
+			]
+		})
+	});
+	if (isCenter) {
+		if (outsideContent) return /* @__PURE__ */ jsx(PaddleNavContext.Provider, {
+			value: paddleNavContextValue,
+			children: /* @__PURE__ */ jsxs(Box, {
+				ref,
+				dir: isHorizontalCenter ? "ltr" : void 0,
+				display: "inline-flex",
+				alignItems: "center",
+				justifyContent: "center",
+				flexDirection: isVertical ? "column" : "row",
+				columnGap: isVertical ? void 0 : "2",
+				rowGap: isVertical ? "2" : void 0,
+				className,
+				"data-paddle-nav-orientation": orientation,
+				"data-paddle-nav-outside": "true",
+				...rest,
+				children: [
+					previousPaddle,
+					/* @__PURE__ */ jsx("div", {
+						className: cx("relative min-w-0 min-h-0 flex-1"),
+						children: contentNodes
+					}),
+					nextPaddle,
+					passthroughNodes
+				]
+			})
+		});
+		return /* @__PURE__ */ jsx(PaddleNavContext.Provider, {
+			value: paddleNavContextValue,
+			children: /* @__PURE__ */ jsxs("div", {
+				ref,
+				className: cx("relative inline-block", className),
+				"data-paddle-nav-orientation": orientation,
+				"data-paddle-nav-outside": "false",
+				...rest,
+				children: [
+					contentNodes,
+					previousPaddle && /* @__PURE__ */ jsx("div", {
+						className: getPaddleWrapperClassName(cx("absolute z-10 pointer-events-auto", isVertical ? "top-2 left-1/2 -translate-x-1/2" : horizontalOverlayStartClass), paddleHiddenByRole.previous),
+						children: previousPaddle
+					}),
+					nextPaddle && /* @__PURE__ */ jsx("div", {
+						className: getPaddleWrapperClassName(cx("absolute z-10 pointer-events-auto", isVertical ? "bottom-2 left-1/2 -translate-x-1/2" : horizontalOverlayEndClass), paddleHiddenByRole.next),
+						children: nextPaddle
+					}),
+					passthroughNodes
+				]
+			})
+		});
+	}
+	return /* @__PURE__ */ jsx(PaddleNavContext.Provider, {
+		value: paddleNavContextValue,
+		children: /* @__PURE__ */ jsxs("div", {
+			ref,
+			className: cx("relative inline-block", className),
+			"data-paddle-nav-orientation": orientation,
+			"data-paddle-nav-outside": outsideContent ? "true" : "false",
+			...rest,
+			children: [
+				contentNodes,
+				(previousPaddle || nextPaddle) && physicalCornerOrientation && /* @__PURE__ */ jsxs("div", {
+					dir: "ltr",
+					className: cx("absolute z-10", paddleClusterClassName, getCornerInsetClasses(physicalCornerOrientation, outsideContent)),
+					children: [previousPaddle, nextPaddle]
+				}),
+				passthroughNodes
+			]
+		})
+	});
+});
+PaddleNav.displayName = "PaddleNav";
+//#endregion
+export { PaddleNav };

package/dist/components/client/PaddleNav/PaddleNavContent.cjs

@@ -0,0 +1,29 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../../_virtual/_rolldown/runtime.cjs");
+const require_styles_styler = require("../../../styles/styler.cjs");
+let react = require("react");
+let react_jsx_runtime = require("react/jsx-runtime");
+//#region src/components/client/PaddleNav/PaddleNavContent.tsx
+const PaddleNavContent = (0, react.forwardRef)(function PaddleNavContent({ asChild = false, className, children, ...rest }, ref) {
+	const mergedClassName = require_styles_styler.cx("min-w-0 min-h-0 relative", className);
+	if (asChild && (0, react.isValidElement)(children)) {
+		const child = children;
+		return (0, react.cloneElement)(child, {
+			...rest,
+			className: require_styles_styler.cx(mergedClassName, child.props.className),
+			"data-paddle-content": "true"
+		});
+	}
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		ref,
+		className: mergedClassName,
+		"data-paddle-content": "true",
+		...rest,
+		children
+	});
+});
+PaddleNavContent.displayName = "PaddleNavContent";
+//#endregion
+exports.PaddleNavContent = PaddleNavContent;

package/dist/components/client/PaddleNav/PaddleNavContent.d.cts

@@ -0,0 +1,11 @@
+
+import { UniversalPaddleNavContentProps } from "../../../types/dist/index.cjs";
+import * as _$react from "react";
+import { HTMLAttributes } from "react";
+
+//#region src/components/client/PaddleNav/PaddleNavContent.d.ts
+type HtmlDivProps = Omit<HTMLAttributes<HTMLDivElement>, 'color'>;
+type PaddleNavContentProps = UniversalPaddleNavContentProps & HtmlDivProps;
+declare const PaddleNavContent: _$react.ForwardRefExoticComponent<UniversalPaddleNavContentProps & HtmlDivProps & _$react.RefAttributes<HTMLElement>>;
+//#endregion
+export { PaddleNavContent, type PaddleNavContentProps };

package/dist/components/client/PaddleNav/PaddleNavContent.d.ts

@@ -0,0 +1,12 @@
+
+"use client";
+import { UniversalPaddleNavContentProps } from "../../../types/dist/index.js";
+import * as _$react from "react";
+import { HTMLAttributes } from "react";
+
+//#region src/components/client/PaddleNav/PaddleNavContent.d.ts
+type HtmlDivProps = Omit<HTMLAttributes<HTMLDivElement>, 'color'>;
+type PaddleNavContentProps = UniversalPaddleNavContentProps & HtmlDivProps;
+declare const PaddleNavContent: _$react.ForwardRefExoticComponent<UniversalPaddleNavContentProps & HtmlDivProps & _$react.RefAttributes<HTMLElement>>;
+//#endregion
+export { PaddleNavContent, type PaddleNavContentProps };

package/dist/components/client/PaddleNav/PaddleNavContent.js

@@ -0,0 +1,27 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+import { cx } from "../../../styles/styler.js";
+import { cloneElement, forwardRef, isValidElement } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/components/client/PaddleNav/PaddleNavContent.tsx
+const PaddleNavContent = forwardRef(function PaddleNavContent({ asChild = false, className, children, ...rest }, ref) {
+	const mergedClassName = cx("min-w-0 min-h-0 relative", className);
+	if (asChild && isValidElement(children)) {
+		const child = children;
+		return cloneElement(child, {
+			...rest,
+			className: cx(mergedClassName, child.props.className),
+			"data-paddle-content": "true"
+		});
+	}
+	return /* @__PURE__ */ jsx("div", {
+		ref,
+		className: mergedClassName,
+		"data-paddle-content": "true",
+		...rest,
+		children
+	});
+});
+PaddleNavContent.displayName = "PaddleNavContent";
+//#endregion
+export { PaddleNavContent };

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

@@ -0,0 +1,11 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_components_client_PaddleNav_PaddleButtonNext = require("./PaddleButtonNext.cjs");
+const require_components_client_PaddleNav_PaddleButtonPrevious = require("./PaddleButtonPrevious.cjs");
+const require_components_client_PaddleNav_PaddleNavContent = require("./PaddleNavContent.cjs");
+const require_components_client_PaddleNav_PaddleNav = require("./PaddleNav.cjs");
+exports.PaddleButtonNext = require_components_client_PaddleNav_PaddleButtonNext.PaddleButtonNext;
+exports.PaddleButtonPrevious = require_components_client_PaddleNav_PaddleButtonPrevious.PaddleButtonPrevious;
+exports.PaddleNav = require_components_client_PaddleNav_PaddleNav.PaddleNav;
+exports.PaddleNavContent = require_components_client_PaddleNav_PaddleNavContent.PaddleNavContent;

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

@@ -0,0 +1,6 @@
+
+import { PaddleButtonNext, PaddleButtonNextProps } from "./PaddleButtonNext.cjs";
+import { PaddleButtonPrevious, PaddleButtonPreviousProps } from "./PaddleButtonPrevious.cjs";
+import { PaddleNav, PaddleNavProps } from "./PaddleNav.cjs";
+import { PaddleNavContent, PaddleNavContentProps } from "./PaddleNavContent.cjs";
+export { PaddleButtonNext, PaddleButtonNextProps, PaddleButtonPrevious, PaddleButtonPreviousProps, PaddleNav, PaddleNavContent, PaddleNavContentProps, PaddleNavProps };

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

@@ -0,0 +1,7 @@
+
+"use client";
+import { PaddleButtonNext, PaddleButtonNextProps } from "./PaddleButtonNext.js";
+import { PaddleButtonPrevious, PaddleButtonPreviousProps } from "./PaddleButtonPrevious.js";
+import { PaddleNav, PaddleNavProps } from "./PaddleNav.js";
+import { PaddleNavContent, PaddleNavContentProps } from "./PaddleNavContent.js";
+export { PaddleButtonNext, PaddleButtonNextProps, PaddleButtonPrevious, PaddleButtonPreviousProps, PaddleNav, PaddleNavContent, PaddleNavContentProps, PaddleNavProps };

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

@@ -0,0 +1,7 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+import { PaddleButtonNext } from "./PaddleButtonNext.js";
+import { PaddleButtonPrevious } from "./PaddleButtonPrevious.js";
+import { PaddleNavContent } from "./PaddleNavContent.js";
+import { PaddleNav } from "./PaddleNav.js";
+export { PaddleButtonNext, PaddleButtonPrevious, PaddleNav, PaddleNavContent };

package/dist/components/client/PaddleNav/paddleButtonIcons.cjs

@@ -0,0 +1,12 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../../_virtual/_rolldown/runtime.cjs");
+let _yahoo_uds_icons = require("@yahoo/uds-icons");
+//#region src/components/client/PaddleNav/paddleButtonIcons.ts
+function pickDefaultPaddleIcon(orientation, role) {
+	if (orientation === "vertical") return role === "previous" ? _yahoo_uds_icons.ChevronUp : _yahoo_uds_icons.ChevronDown;
+	return role === "previous" ? _yahoo_uds_icons.ChevronLeft : _yahoo_uds_icons.ChevronRight;
+}
+//#endregion
+exports.pickDefaultPaddleIcon = pickDefaultPaddleIcon;

package/dist/components/client/PaddleNav/paddleButtonIcons.d.cts

@@ -0,0 +1,22 @@
+
+import { PaddleNavOrientation } from "../../../types/dist/index.cjs";
+import { IconVariant, SvgIconProps } from "../../../icons/dist/types.cjs";
+import { PaddleButtonRole } from "./paddleNavContext.cjs";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/client/PaddleNav/paddleButtonIcons.d.ts
+declare function pickDefaultPaddleIcon(orientation: PaddleNavOrientation, role: PaddleButtonRole): {
+  ({
+    size,
+    variant
+  }: SvgIconProps): _$react_jsx_runtime0.JSX.Element;
+  metadata: {
+    name: string;
+    isSvgIcon: boolean;
+    variants: IconVariant[];
+    category: string;
+    tags: string[];
+  };
+};
+//#endregion
+export { pickDefaultPaddleIcon };

package/dist/components/client/PaddleNav/paddleButtonIcons.d.ts

@@ -0,0 +1,23 @@
+
+"use client";
+import { PaddleNavOrientation } from "../../../types/dist/index.js";
+import { IconVariant, SvgIconProps } from "../../../icons/dist/types.js";
+import { PaddleButtonRole } from "./paddleNavContext.js";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/client/PaddleNav/paddleButtonIcons.d.ts
+declare function pickDefaultPaddleIcon(orientation: PaddleNavOrientation, role: PaddleButtonRole): {
+  ({
+    size,
+    variant
+  }: SvgIconProps): _$react_jsx_runtime0.JSX.Element;
+  metadata: {
+    name: string;
+    isSvgIcon: boolean;
+    variants: IconVariant[];
+    category: string;
+    tags: string[];
+  };
+};
+//#endregion
+export { pickDefaultPaddleIcon };

package/dist/components/client/PaddleNav/paddleButtonIcons.js

@@ -0,0 +1,10 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+import { ChevronDown, ChevronLeft, ChevronRight, ChevronUp } from "@yahoo/uds-icons";
+//#region src/components/client/PaddleNav/paddleButtonIcons.ts
+function pickDefaultPaddleIcon(orientation, role) {
+	if (orientation === "vertical") return role === "previous" ? ChevronUp : ChevronDown;
+	return role === "previous" ? ChevronLeft : ChevronRight;
+}
+//#endregion
+export { pickDefaultPaddleIcon };

package/dist/components/client/PaddleNav/paddleNavContext.cjs

@@ -0,0 +1,20 @@
+/*! © 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");
+//#region src/components/client/PaddleNav/paddleNavContext.tsx
+const PaddleNavContext = (0, react.createContext)(null);
+function usePaddleNavContext() {
+	const value = (0, react.useContext)(PaddleNavContext);
+	if (!value) throw new Error("PaddleButtonPrevious, PaddleButtonNext, and PaddleNavContent must be used within a PaddleNav component.");
+	return value;
+}
+const defaultPaddleHiddenByRole = {
+	previous: false,
+	next: false
+};
+//#endregion
+exports.PaddleNavContext = PaddleNavContext;
+exports.defaultPaddleHiddenByRole = defaultPaddleHiddenByRole;
+exports.usePaddleNavContext = usePaddleNavContext;

package/dist/components/client/PaddleNav/paddleNavContext.d.cts

@@ -0,0 +1,20 @@
+
+import { PaddleNavOrientation, PaddleNavSize, PaddleNavVariant } from "../../../types/dist/index.cjs";
+import * as _$react from "react";
+
+//#region src/components/client/PaddleNav/paddleNavContext.d.ts
+type PaddleButtonRole = 'previous' | 'next';
+type PaddleHiddenByRole = Record<PaddleButtonRole, boolean>;
+interface PaddleNavContextValue {
+  orientation: PaddleNavOrientation;
+  outsideContent: boolean;
+  variant: PaddleNavVariant;
+  size: PaddleNavSize;
+  paddleHiddenByRole: PaddleHiddenByRole;
+  registerPaddleHidden: (role: PaddleButtonRole, hidden: boolean) => void;
+}
+declare const PaddleNavContext: _$react.Context<PaddleNavContextValue | null>;
+declare function usePaddleNavContext(): PaddleNavContextValue;
+declare const defaultPaddleHiddenByRole: PaddleHiddenByRole;
+//#endregion
+export { type PaddleButtonRole, type PaddleHiddenByRole, PaddleNavContext, type PaddleNavContextValue, defaultPaddleHiddenByRole, usePaddleNavContext };

package/dist/components/client/PaddleNav/paddleNavContext.d.ts

@@ -0,0 +1,21 @@
+
+"use client";
+import { PaddleNavOrientation, PaddleNavSize, PaddleNavVariant } from "../../../types/dist/index.js";
+import * as _$react from "react";
+
+//#region src/components/client/PaddleNav/paddleNavContext.d.ts
+type PaddleButtonRole = 'previous' | 'next';
+type PaddleHiddenByRole = Record<PaddleButtonRole, boolean>;
+interface PaddleNavContextValue {
+  orientation: PaddleNavOrientation;
+  outsideContent: boolean;
+  variant: PaddleNavVariant;
+  size: PaddleNavSize;
+  paddleHiddenByRole: PaddleHiddenByRole;
+  registerPaddleHidden: (role: PaddleButtonRole, hidden: boolean) => void;
+}
+declare const PaddleNavContext: _$react.Context<PaddleNavContextValue | null>;
+declare function usePaddleNavContext(): PaddleNavContextValue;
+declare const defaultPaddleHiddenByRole: PaddleHiddenByRole;
+//#endregion
+export { type PaddleButtonRole, type PaddleHiddenByRole, PaddleNavContext, type PaddleNavContextValue, defaultPaddleHiddenByRole, usePaddleNavContext };

package/dist/components/client/PaddleNav/paddleNavContext.js

@@ -0,0 +1,16 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+import { createContext, useContext } from "react";
+//#region src/components/client/PaddleNav/paddleNavContext.tsx
+const PaddleNavContext = createContext(null);
+function usePaddleNavContext() {
+	const value = useContext(PaddleNavContext);
+	if (!value) throw new Error("PaddleButtonPrevious, PaddleButtonNext, and PaddleNavContent must be used within a PaddleNav component.");
+	return value;
+}
+const defaultPaddleHiddenByRole = {
+	previous: false,
+	next: false
+};
+//#endregion
+export { PaddleNavContext, defaultPaddleHiddenByRole, usePaddleNavContext };

package/dist/components/client/PaddleNav/utils/resolvePaddleNavCornerOrientation.cjs

@@ -0,0 +1,25 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/components/client/PaddleNav/utils/resolvePaddleNavCornerOrientation.ts
+function isCenterOrientation(orientation) {
+	return orientation === "horizontal" || orientation === "vertical";
+}
+/**
+* Maps directionally-agnostic corner orientations to physical corners for layout.
+* - `top-start` -> `top-left` (or `top-right` in RTL)
+* - `top-end` -> `top-right` (or `top-left` in RTL)
+* - `bottom-start` -> `bottom-left` (or `bottom-right` in RTL)
+* - `bottom-end` -> `bottom-right` (or `bottom-left` in RTL)
+*/
+function resolvePaddleNavCornerOrientation(orientation, rtl) {
+	if (isCenterOrientation(orientation)) return orientation;
+	switch (orientation) {
+		case "top-start": return rtl ? "top-right" : "top-left";
+		case "top-end": return rtl ? "top-left" : "top-right";
+		case "bottom-start": return rtl ? "bottom-right" : "bottom-left";
+		case "bottom-end": return rtl ? "bottom-left" : "bottom-right";
+	}
+}
+//#endregion
+exports.resolvePaddleNavCornerOrientation = resolvePaddleNavCornerOrientation;

package/dist/components/client/PaddleNav/utils/resolvePaddleNavCornerOrientation.d.cts

@@ -0,0 +1,16 @@
+
+import { PaddleNavOrientation } from "../../../../types/dist/index.cjs";
+
+//#region src/components/client/PaddleNav/utils/resolvePaddleNavCornerOrientation.d.ts
+type PhysicalCornerOrientation = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+type ResolvedPaddleNavLayoutOrientation = PhysicalCornerOrientation | Extract<PaddleNavOrientation, 'horizontal' | 'vertical'>;
+/**
+ * Maps directionally-agnostic corner orientations to physical corners for layout.
+ * - `top-start` -> `top-left` (or `top-right` in RTL)
+ * - `top-end` -> `top-right` (or `top-left` in RTL)
+ * - `bottom-start` -> `bottom-left` (or `bottom-right` in RTL)
+ * - `bottom-end` -> `bottom-right` (or `bottom-left` in RTL)
+ */
+declare function resolvePaddleNavCornerOrientation(orientation: PaddleNavOrientation, rtl: boolean): ResolvedPaddleNavLayoutOrientation;
+//#endregion
+export { type PhysicalCornerOrientation, type ResolvedPaddleNavLayoutOrientation, resolvePaddleNavCornerOrientation };

package/dist/components/client/PaddleNav/utils/resolvePaddleNavCornerOrientation.d.ts

@@ -0,0 +1,17 @@
+
+"use client";
+import { PaddleNavOrientation } from "../../../../types/dist/index.js";
+
+//#region src/components/client/PaddleNav/utils/resolvePaddleNavCornerOrientation.d.ts
+type PhysicalCornerOrientation = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+type ResolvedPaddleNavLayoutOrientation = PhysicalCornerOrientation | Extract<PaddleNavOrientation, 'horizontal' | 'vertical'>;
+/**
+ * Maps directionally-agnostic corner orientations to physical corners for layout.
+ * - `top-start` -> `top-left` (or `top-right` in RTL)
+ * - `top-end` -> `top-right` (or `top-left` in RTL)
+ * - `bottom-start` -> `bottom-left` (or `bottom-right` in RTL)
+ * - `bottom-end` -> `bottom-right` (or `bottom-left` in RTL)
+ */
+declare function resolvePaddleNavCornerOrientation(orientation: PaddleNavOrientation, rtl: boolean): ResolvedPaddleNavLayoutOrientation;
+//#endregion
+export { type PhysicalCornerOrientation, type ResolvedPaddleNavLayoutOrientation, resolvePaddleNavCornerOrientation };

package/dist/components/client/PaddleNav/utils/resolvePaddleNavCornerOrientation.js

@@ -0,0 +1,24 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+//#region src/components/client/PaddleNav/utils/resolvePaddleNavCornerOrientation.ts
+function isCenterOrientation(orientation) {
+	return orientation === "horizontal" || orientation === "vertical";
+}
+/**
+* Maps directionally-agnostic corner orientations to physical corners for layout.
+* - `top-start` -> `top-left` (or `top-right` in RTL)
+* - `top-end` -> `top-right` (or `top-left` in RTL)
+* - `bottom-start` -> `bottom-left` (or `bottom-right` in RTL)
+* - `bottom-end` -> `bottom-right` (or `bottom-left` in RTL)
+*/
+function resolvePaddleNavCornerOrientation(orientation, rtl) {
+	if (isCenterOrientation(orientation)) return orientation;
+	switch (orientation) {
+		case "top-start": return rtl ? "top-right" : "top-left";
+		case "top-end": return rtl ? "top-left" : "top-right";
+		case "bottom-start": return rtl ? "bottom-right" : "bottom-left";
+		case "bottom-end": return rtl ? "bottom-left" : "bottom-right";
+	}
+}
+//#endregion
+export { resolvePaddleNavCornerOrientation };

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

@@ -29,7 +29,7 @@ declare function usePopoverConfig(sizeProp?: PopoverSize | undefined, variantPro
   gap: SpacingAlias;
   dismissButtonSpacing: SpacingAlias;
   dismissIconSize: number;
-  ariaKitPlacement: ("top-start" | "top-end" | "bottom-start" | "bottom-end" | ("top" | "bottom" | "left" | "right") | "left-start" | "right-start" | "left-end" | "right-end") | undefined;
+  ariaKitPlacement: ("bottom-start" | "bottom-end" | "top-start" | "top-end" | ("bottom" | "left" | "right" | "top") | "left-start" | "right-start" | "left-end" | "right-end") | undefined;
   animationDuration: number;
 };
 //#endregion

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

@@ -30,7 +30,7 @@ declare function usePopoverConfig(sizeProp?: PopoverSize | undefined, variantPro
   gap: SpacingAlias;
   dismissButtonSpacing: SpacingAlias;
   dismissIconSize: number;
-  ariaKitPlacement: ("top-start" | "top-end" | "bottom-start" | "bottom-end" | ("top" | "bottom" | "left" | "right") | "left-start" | "right-start" | "left-end" | "right-end") | undefined;
+  ariaKitPlacement: ("bottom-start" | "bottom-end" | "top-start" | "top-end" | ("bottom" | "left" | "right" | "top") | "left-start" | "right-start" | "left-end" | "right-end") | undefined;
   animationDuration: number;
 };
 //#endregion