@primer/react 38.34.0-rc.f86dc8614 → 38.35.0-rc.f27c5cca1

package/dist/TextInput/TextInput.js

@@ -1,5 +1,7 @@
+import { useMergedRefs } from "../hooks/useMergedRefs.js";
 import { useProvidedRefOrCreate } from "../hooks/useProvidedRefOrCreate.js";
 import { AriaStatus } from "../live-region/AriaStatus.js";
+import { useFeatureFlag } from "../FeatureFlags/useFeatureFlag.js";
 import Text_default from "../Text/Text.js";
 import _VisuallyHidden_module_css_default from "../_VisuallyHidden.module.css.js";
 import VisuallyHidden from "../_VisuallyHidden.js";
@@ -11,14 +13,19 @@ import UnstyledTextInput from "../internal/components/UnstyledTextInput.js";
 import { getCharacterCountState } from "../utils/character-counter.js";
 import { clsx } from "clsx";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import React, { useCallback, useId, useState } from "react";
+import React, { useCallback, useId, useRef, useState } from "react";
 import { isValidElementType } from "react-is";
 import { AlertFillIcon } from "@primer/octicons-react";
 //#region src/TextInput/TextInput.tsx
 const TextInput = /*#__PURE__*/ React.forwardRef(({ icon: IconComponent, leadingVisual: LeadingVisual, trailingVisual: TrailingVisual, trailingAction, block, className, contrast, disabled, loading, loaderPosition = "auto", loaderText = "Loading", monospace, validationStatus, size: sizeProp, onFocus, onBlur, variant: variantProp, width: widthProp, minWidth: minWidthProp, maxWidth: maxWidthProp, type = "text", required, characterLimit, onChange, value, defaultValue, "data-component": dataComponent, ...inputProps }, ref) => {
 	var _counter$isOverLimit;
 	const [isInputFocused, setIsInputFocused] = useState(false);
-	const inputRef = useProvidedRefOrCreate(ref);
+	const mergedRefEnabled = useFeatureFlag("primer_react_merged_forwarded_refs");
+	const inputRef = useRef(null);
+	const mergedRef = useMergedRefs(inputRef, ref);
+	const providedOrCreatedRef = useProvidedRefOrCreate(ref);
+	const readRef = mergedRefEnabled ? inputRef : providedOrCreatedRef;
+	const appliedRef = mergedRefEnabled ? mergedRef : providedOrCreatedRef;
 	const isControlled = value !== void 0;
 	const [uncontrolledLength, setUncontrolledLength] = useState(() => defaultValue !== void 0 ? String(defaultValue).length : 0);
 	const currentLength = isControlled ? String(value).length : uncontrolledLength;
@@ -29,9 +36,9 @@ const TextInput = /*#__PURE__*/ React.forwardRef(({ icon: IconComponent, leading
 	const showTrailingLoadingIndicator = loading && (loaderPosition === "trailing" || Boolean(loaderPosition === "auto" && !LeadingVisual));
 	const isSegmentedInputType = type === "date" || type === "time" || type === "datetime-local";
 	const focusInput = (e) => {
-		if (e.target !== inputRef.current || !isSegmentedInputType) {
-			var _inputRef$current;
-			(_inputRef$current = inputRef.current) === null || _inputRef$current === void 0 || _inputRef$current.focus();
+		if (e.target !== readRef.current || !isSegmentedInputType) {
+			var _readRef$current;
+			(_readRef$current = readRef.current) === null || _readRef$current === void 0 || _readRef$current.focus();
 		}
 	};
 	const leadingVisualId = useId();
@@ -88,7 +95,7 @@ const TextInput = /*#__PURE__*/ React.forwardRef(({ icon: IconComponent, leading
 				children: typeof LeadingVisual !== "string" && isValidElementType(LeadingVisual) ? /*#__PURE__*/ jsx(LeadingVisual, {}) : LeadingVisual
 			}),
 			/*#__PURE__*/ jsx(UnstyledTextInput, {
-				ref: inputRef,
+				ref: appliedRef,
 				disabled,
 				onFocus: handleInputFocus,
 				onBlur: handleInputBlur,

package/dist/TooltipV2/Tooltip.js

@@ -1,7 +1,9 @@
+import { useMergedRefs } from "../hooks/useMergedRefs.js";
 import { useProvidedRefOrCreate } from "../hooks/useProvidedRefOrCreate.js";
 import { useOnEscapePress } from "../hooks/useOnEscapePress.js";
 import { useId as useId$1 } from "../hooks/useId.js";
 import { warning } from "../utils/warning.js";
+import { useFeatureFlag } from "../FeatureFlags/useFeatureFlag.js";
 import { invariant } from "../utils/invariant.js";
 import Tooltip_module_css_default from "./Tooltip.module.css.js";
 import VisuallyHidden from "../_VisuallyHidden.js";
@@ -80,7 +82,12 @@ const emptyKeybindingHints = [];
 const Tooltip = /*#__PURE__*/ React.forwardRef(({ direction = "s", text, type = "description", children, id, className, keybindingHint = emptyKeybindingHints, delay = "short", _privateDisableTooltip = false, ...rest }, forwardedRef) => {
 	const tooltipId = useId$1(id);
 	const child = Children.only(children);
-	const triggerRef = useProvidedRefOrCreate(forwardedRef);
+	const mergedRefEnabled = useFeatureFlag("primer_react_merged_forwarded_refs");
+	const triggerRef = useRef(null);
+	const mergedTriggerRef = useMergedRefs(triggerRef, forwardedRef);
+	const providedOrCreatedRef = useProvidedRefOrCreate(forwardedRef);
+	const readTriggerRef = mergedRefEnabled ? triggerRef : providedOrCreatedRef;
+	const appliedTriggerRef = mergedRefEnabled ? mergedTriggerRef : providedOrCreatedRef;
 	const tooltipElRef = useRef(null);
 	const [calculatedDirection, setCalculatedDirection] = useState(direction);
 	const [isPopoverOpen, setIsPopoverOpen] = useState(false);
@@ -88,9 +95,9 @@ const Tooltip = /*#__PURE__*/ React.forwardRef(({ direction = "s", text, type =
 	const { safeSetTimeout, safeClearTimeout } = useSafeTimeout();
 	const openTooltip = () => {
 		try {
-			if (tooltipElRef.current && triggerRef.current && tooltipElRef.current.hasAttribute("popover") && !tooltipElRef.current.matches(":popover-open") && !_privateDisableTooltip) {
+			if (tooltipElRef.current && readTriggerRef.current && tooltipElRef.current.hasAttribute("popover") && !tooltipElRef.current.matches(":popover-open") && !_privateDisableTooltip) {
 				const tooltip = tooltipElRef.current;
-				const trigger = triggerRef.current;
+				const trigger = readTriggerRef.current;
 				tooltip.showPopover();
 				setIsPopoverOpen(true);
 				const { top, left, anchorAlign, anchorSide } = getAnchoredPosition(tooltip, trigger, {
@@ -112,7 +119,7 @@ const Tooltip = /*#__PURE__*/ React.forwardRef(({ direction = "s", text, type =
 			openTimeoutRef.current = null;
 		}
 		try {
-			if (tooltipElRef.current && triggerRef.current && tooltipElRef.current.hasAttribute("popover") && tooltipElRef.current.matches(":popover-open")) {
+			if (tooltipElRef.current && readTriggerRef.current && tooltipElRef.current.hasAttribute("popover") && tooltipElRef.current.matches(":popover-open")) {
 				tooltipElRef.current.hidePopover();
 				setIsPopoverOpen(false);
 			} else setIsPopoverOpen(false);
@@ -122,16 +129,16 @@ const Tooltip = /*#__PURE__*/ React.forwardRef(({ direction = "s", text, type =
 	};
 	const value = useMemo(() => ({ tooltipId }), [tooltipId]);
 	useEffect(() => {
-		if (!tooltipElRef.current || !triggerRef.current) return;
-		const isTriggerInteractive = isInteractive(triggerRef.current);
-		const triggerChildren = triggerRef.current.childNodes;
+		if (!tooltipElRef.current || !readTriggerRef.current) return;
+		const isTriggerInteractive = isInteractive(readTriggerRef.current);
+		const triggerChildren = readTriggerRef.current.childNodes;
 		const hasInteractiveDescendant = Array.from(triggerChildren).some((child) => {
 			return child instanceof HTMLElement && isInteractive(child) || Array.from(child.childNodes).some((grandChild) => grandChild instanceof HTMLElement && isInteractive(grandChild));
 		});
 		!(isTriggerInteractive || hasInteractiveDescendant) && invariant(false, "The `Tooltip` component expects a single React element that contains interactive content. Consider using a `<button>` or equivalent interactive element instead.");
 		if (type === "label") {
-			const hasAriaLabel = triggerRef.current.hasAttribute("aria-label");
-			const hasAriaLabelInChildren = Array.from(triggerRef.current.childNodes).some((child) => child instanceof HTMLElement && child.hasAttribute("aria-label"));
+			const hasAriaLabel = readTriggerRef.current.hasAttribute("aria-label");
+			const hasAriaLabelInChildren = Array.from(readTriggerRef.current.childNodes).some((child) => child instanceof HTMLElement && child.hasAttribute("aria-label"));
 			warning(hasAriaLabel || hasAriaLabelInChildren, "The label type `Tooltip` is going to be used here to label the trigger element. Please remove the aria-label from the trigger element.");
 		}
 		if (typeof window !== "undefined") {
@@ -140,7 +147,7 @@ const Tooltip = /*#__PURE__*/ React.forwardRef(({ direction = "s", text, type =
 		tooltipElRef.current.setAttribute("popover", "auto");
 	}, [
 		tooltipElRef,
-		triggerRef,
+		readTriggerRef,
 		direction,
 		type
 	]);
@@ -157,7 +164,7 @@ const Tooltip = /*#__PURE__*/ React.forwardRef(({ direction = "s", text, type =
 	return /*#__PURE__*/ jsx(TooltipContext.Provider, {
 		value,
 		children: /*#__PURE__*/ jsxs(Fragment, { children: [/*#__PURE__*/ React.isValidElement(child) && /*#__PURE__*/ React.cloneElement(child, {
-			ref: triggerRef,
+			ref: appliedTriggerRef,
 			"aria-describedby": (() => {
 				if (type !== "description") return child.props["aria-describedby"];
 				const existingDescribedBy = child.props["aria-describedby"];

package/dist/experimental/Tabs/Tabs.js

@@ -13,10 +13,11 @@ import React, { useId } from "react";
 * The `Tab`, `TabList`, and `TabPanel` components are provided for convenience to showcase the API & implementation.
 */
 function Tabs(props) {
-	var _props$defaultValue;
+	var _props$id, _props$defaultValue;
 	const $ = c(13);
 	const { children, onValueChange } = props;
-	const groupId = useId();
+	const generatedId = useId();
+	const groupId = (_props$id = props.id) !== null && _props$id !== void 0 ? _props$id : generatedId;
 	const t0 = (_props$defaultValue = props.defaultValue) !== null && _props$defaultValue !== void 0 ? _props$defaultValue : props.value;
 	let t1;
 	if ($[0] !== props.value || $[1] !== t0) {

package/dist/experimental/Tabs/types.d.ts

@@ -45,7 +45,14 @@ type UncontrolledTabsProps = {
     value: string;
   }) => void;
 };
-type TabsProps = PropsWithChildren<ControlledTabsProps | UncontrolledTabsProps>;
+type CommonTabsProps = {
+  /**
+   * Optional id used as the base for generated tab and panel ids. If omitted, a
+   * unique id is generated automatically.
+   */
+  id?: string;
+};
+type TabsProps = PropsWithChildren<(ControlledTabsProps | UncontrolledTabsProps) & CommonTabsProps>;
 type Label = {
   'aria-label': string;
 };
@@ -73,7 +80,7 @@ type TabPanelProps = {
   value: string;
 };
 type TabListHookProps<T extends HTMLElement> = TabListProps & {
-  /** Optional ref to use for the tablist. If none is provided, one will be generated automatically */ref?: React.RefObject<T>;
+  /** Optional ref to use for the tablist. If none is provided, one will be generated automatically */ref?: React.Ref<T | null>;
 };
 type TabListHookResult<T extends HTMLElement> = {
   /** Props to be spread onto the tablist element */tabListProps: {
@@ -81,7 +88,7 @@ type TabListHookResult<T extends HTMLElement> = {
     'aria-orientation': AriaAttributes['aria-orientation'];
     'aria-label': AriaAttributes['aria-label'];
     'aria-labelledby': AriaAttributes['aria-labelledby'];
-    ref: React.RefObject<T | null>;
+    ref: React.Ref<T | null>;
     role: 'tablist';
   };
 };

package/dist/experimental/Tabs/useTabList.js

@@ -1,14 +1,22 @@
+import { useMergedRefs } from "../../hooks/useMergedRefs.js";
 import { useProvidedRefOrCreate } from "../../hooks/useProvidedRefOrCreate.js";
+import { useFeatureFlag } from "../../FeatureFlags/useFeatureFlag.js";
 import { c } from "react-compiler-runtime";
+import { useRef } from "react";
 //#region src/experimental/Tabs/useTabList.ts
 function useTabList(props) {
 	const $ = c(9);
 	const { "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, "aria-orientation": ariaOrientation } = props;
-	const ref = useProvidedRefOrCreate(props.ref);
+	const mergedRefEnabled = useFeatureFlag("primer_react_merged_forwarded_refs");
+	const tabListRef = useRef(null);
+	const mergedRef = useMergedRefs(tabListRef, props.ref);
+	const providedOrCreatedRef = useProvidedRefOrCreate(props.ref);
+	const readRef = mergedRefEnabled ? tabListRef : providedOrCreatedRef;
+	const appliedRef = mergedRefEnabled ? mergedRef : providedOrCreatedRef;
 	let t0;
-	if ($[0] !== ariaOrientation || $[1] !== ref) {
+	if ($[0] !== ariaOrientation || $[1] !== readRef) {
 		t0 = (event) => {
-			const { current: tablist } = ref;
+			const { current: tablist } = readRef;
 			if (tablist === null) return;
 			const tabs = getFocusableTabs(tablist);
 			const isVertical = ariaOrientation === "vertical";
@@ -33,25 +41,25 @@ function useTabList(props) {
 			}
 		};
 		$[0] = ariaOrientation;
-		$[1] = ref;
+		$[1] = readRef;
 		$[2] = t0;
 	} else t0 = $[2];
 	const onKeyDown = t0;
 	const t1 = ariaOrientation !== null && ariaOrientation !== void 0 ? ariaOrientation : "horizontal";
 	let t2;
-	if ($[3] !== ariaLabel || $[4] !== ariaLabelledby || $[5] !== onKeyDown || $[6] !== ref || $[7] !== t1) {
+	if ($[3] !== appliedRef || $[4] !== ariaLabel || $[5] !== ariaLabelledby || $[6] !== onKeyDown || $[7] !== t1) {
 		t2 = { tabListProps: {
-			ref,
+			ref: appliedRef,
 			"aria-label": ariaLabel,
 			"aria-labelledby": ariaLabelledby,
 			"aria-orientation": t1,
 			role: "tablist",
 			onKeyDown
 		} };
-		$[3] = ariaLabel;
-		$[4] = ariaLabelledby;
-		$[5] = onKeyDown;
-		$[6] = ref;
+		$[3] = appliedRef;
+		$[4] = ariaLabel;
+		$[5] = ariaLabelledby;
+		$[6] = onKeyDown;
 		$[7] = t1;
 		$[8] = t2;
 	} else t2 = $[8];

package/dist/experimental/UnderlinePanels/UnderlinePanels.js

@@ -3,15 +3,16 @@ import { useResizeObserver } from "../../hooks/useResizeObserver.js";
 import { useId as useId$1 } from "../../hooks/useId.js";
 import { isSlot } from "../../utils/is-slot.js";
 import { invariant } from "../../utils/invariant.js";
-import { createComponent } from "../../utils/create-component.js";
 import { UnderlineItem, UnderlineItemList, UnderlineWrapper } from "../../internal/components/UnderlineTabbedInterface.js";
 import UnderlinePanels_module_css_default from "./UnderlinePanels.module.css.js";
+import { useTab } from "../Tabs/useTab.js";
+import { useTabList } from "../Tabs/useTabList.js";
+import { useTabPanel } from "../Tabs/useTabPanel.js";
+import { Tabs } from "../Tabs/Tabs.js";
 import { clsx } from "clsx";
 import { jsx, jsxs } from "react/jsx-runtime";
 import React, { Children, cloneElement, createContext, isValidElement, useContext, useMemo, useRef, useState } from "react";
-import { TabContainerElement } from "@github/tab-container-element";
 //#region src/experimental/UnderlinePanels/UnderlinePanels.tsx
-const TabContainerComponent = createComponent(TabContainerElement, "tab-container");
 const UnderlinePanelsContext = /*#__PURE__*/ createContext({
 	iconsVisible: true,
 	loadingCounters: void 0
@@ -21,27 +22,43 @@ const UnderlinePanels = ({ "aria-label": ariaLabel, "aria-labelledby": ariaLabel
 	const wrapperRef = useRef(null);
 	const listRef = useRef(null);
 	const parentId = useId$1(props.id);
-	const [tabs, tabPanels, tabsHaveIcons] = useMemo(() => {
+	const [tabs, tabPanels, tabsHaveIcons, selectedFromProps] = useMemo(() => {
 		let tabIndex = 0;
 		let panelIndex = 0;
 		const childrenWithProps = Children.map(children, (child) => {
-			if (/*#__PURE__*/ isValidElement(child) && (child.type === Tab || isSlot(child, Tab))) return /*#__PURE__*/ cloneElement(child, { id: `${parentId}-tab-${tabIndex++}` });
-			if (/*#__PURE__*/ isValidElement(child) && (child.type === Panel || isSlot(child, Panel))) return /*#__PURE__*/ cloneElement(child, { "aria-labelledby": `${parentId}-tab-${panelIndex++}` });
+			if (/*#__PURE__*/ isValidElement(child) && (child.type === Tab || isSlot(child, Tab))) return /*#__PURE__*/ cloneElement(child, { value: `${tabIndex++}` });
+			if (/*#__PURE__*/ isValidElement(child) && (child.type === Panel || isSlot(child, Panel))) return /*#__PURE__*/ cloneElement(child, { value: `${panelIndex++}` });
 			return child;
 		});
 		const tabs = [];
 		const tabPanels = [];
+		let selectedFromProps;
 		for (const child of Children.toArray(childrenWithProps)) {
 			if (!/*#__PURE__*/ isValidElement(child)) continue;
-			if (child.type === Tab || isSlot(child, Tab)) tabs.push(child);
-			else if (child.type === Panel || isSlot(child, Panel)) tabPanels.push(child);
+			if (child.type === Tab || isSlot(child, Tab)) {
+				const ariaSelected = child.props["aria-selected"];
+				if (ariaSelected === true || ariaSelected === "true") selectedFromProps = `${tabs.length}`;
+				tabs.push(child);
+			} else if (child.type === Panel || isSlot(child, Panel)) tabPanels.push(child);
 		}
 		return [
 			tabs,
 			tabPanels,
-			tabs.some((tab) => /*#__PURE__*/ React.isValidElement(tab) && tab.props.icon)
+			tabs.some((tab) => /*#__PURE__*/ React.isValidElement(tab) && tab.props.icon),
+			selectedFromProps
 		];
-	}, [children, parentId]);
+	}, [children]);
+	const [selectedValue, setSelectedValue] = useState(() => selectedFromProps !== null && selectedFromProps !== void 0 ? selectedFromProps : "0");
+	const [prevSelectedFromProps, setPrevSelectedFromProps] = useState(selectedFromProps);
+	if (selectedFromProps !== prevSelectedFromProps) {
+		setPrevSelectedFromProps(selectedFromProps);
+		if (selectedFromProps !== void 0 && selectedFromProps !== selectedValue) setSelectedValue(selectedFromProps);
+	}
+	const { tabListProps } = useTabList({
+		"aria-label": ariaLabel,
+		"aria-labelledby": ariaLabelledBy,
+		ref: listRef
+	});
 	const contextValue = useMemo(() => ({
 		iconsVisible,
 		loadingCounters
@@ -68,55 +85,65 @@ const UnderlinePanels = ({ "aria-label": ariaLabel, "aria-labelledby": ariaLabel
 	!(tabs.length === tabPanels.length) && invariant(false, `The number of tabs and panels must be equal. Counted ${tabs.length} tabs and ${tabPanels.length} panels.`);
 	return /*#__PURE__*/ jsx(UnderlinePanelsContext.Provider, {
 		value: contextValue,
-		children: /*#__PURE__*/ jsxs(TabContainerComponent, { children: [/*#__PURE__*/ jsx(UnderlineWrapper, {
-			ref: wrapperRef,
-			slot: "tablist-wrapper",
-			"data-icons-visible": iconsVisible,
-			className: clsx(className, UnderlinePanels_module_css_default.StyledUnderlineWrapper),
-			...props,
-			children: /*#__PURE__*/ jsx(UnderlineItemList, {
-				ref: listRef,
-				"aria-label": ariaLabel,
-				"aria-labelledby": ariaLabelledBy,
-				role: "tablist",
-				children: tabs
-			})
-		}), tabPanels] })
+		children: /*#__PURE__*/ jsxs(Tabs, {
+			id: parentId,
+			value: selectedValue,
+			onValueChange: ({ value }) => setSelectedValue(value),
+			children: [/*#__PURE__*/ jsx(UnderlineWrapper, {
+				ref: wrapperRef,
+				"data-icons-visible": iconsVisible,
+				className: clsx(className, UnderlinePanels_module_css_default.StyledUnderlineWrapper),
+				...props,
+				children: /*#__PURE__*/ jsx(UnderlineItemList, {
+					ref: listRef,
+					role: tabListProps.role,
+					"aria-label": tabListProps["aria-label"],
+					"aria-labelledby": tabListProps["aria-labelledby"],
+					"aria-orientation": tabListProps["aria-orientation"],
+					onKeyDown: tabListProps.onKeyDown,
+					children: tabs
+				})
+			}), tabPanels]
+		})
 	});
 };
 UnderlinePanels.displayName = "UnderlinePanels";
-const TabImpl = ({ "aria-selected": ariaSelected, onSelect, ...props }) => {
+const TabImpl = ({ onSelect, value, ...itemProps }) => {
 	const { loadingCounters } = useContext(UnderlinePanelsContext);
-	const clickHandler = React.useCallback((event) => {
-		if (!event.defaultPrevented && typeof onSelect === "function") onSelect(event);
-	}, [onSelect]);
-	const keyDownHandler = React.useCallback((event) => {
-		if ((event.key === " " || event.key === "Enter") && !event.defaultPrevented && typeof onSelect === "function") onSelect(event);
-	}, [onSelect]);
+	const { tabProps } = useTab({ value: value !== null && value !== void 0 ? value : "" });
+	const { onKeyDown: tabOnKeyDown, onMouseDown: tabOnMouseDown, onFocus: tabOnFocus, ...restTabProps } = tabProps;
 	return /*#__PURE__*/ jsx(UnderlineItem, {
 		as: "button",
-		role: "tab",
-		tabIndex: ariaSelected ? 0 : -1,
-		"aria-selected": ariaSelected,
+		...itemProps,
+		...restTabProps,
 		type: "button",
-		onClick: clickHandler,
-		onKeyDown: keyDownHandler,
-		loadingCounters,
-		...props
+		onClick: (event) => {
+			if (!event.defaultPrevented && typeof onSelect === "function") onSelect(event);
+		},
+		onKeyDown: (event) => {
+			tabOnKeyDown === null || tabOnKeyDown === void 0 || tabOnKeyDown(event);
+			if ((event.key === " " || event.key === "Enter") && !event.defaultPrevented && typeof onSelect === "function") onSelect(event);
+		},
+		onMouseDown: tabOnMouseDown,
+		onFocus: tabOnFocus,
+		loadingCounters
 	});
 };
 TabImpl.displayName = "TabImpl";
 TabImpl.displayName = "UnderlinePanels.Tab";
 const Tab = /*#__PURE__*/ React.memo(TabImpl);
 Tab.displayName = "UnderlinePanels.Tab";
-const Panel = ({ children, ...rest }) => {
+const PanelImpl = ({ children, value, ...panelRest }) => {
+	const { tabPanelProps } = useTabPanel({ value: value !== null && value !== void 0 ? value : "" });
 	return /*#__PURE__*/ jsx("div", {
-		role: "tabpanel",
-		...rest,
+		...panelRest,
+		...tabPanelProps,
 		children
 	});
 };
-Panel.displayName = "Panel";
+PanelImpl.displayName = "PanelImpl";
+PanelImpl.displayName = "UnderlinePanels.Panel";
+const Panel = PanelImpl;
 Panel.displayName = "UnderlinePanels.Panel";
 var UnderlinePanels_default = Object.assign(UnderlinePanels, {
 	Panel,

package/dist/experimental/index.js

@@ -4,15 +4,15 @@ import { Announce } from "../live-region/Announce.js";
 import { AriaAlert } from "../live-region/AriaAlert.js";
 import { AriaStatus } from "../live-region/AriaStatus.js";
 import { ButtonBase } from "../Button/ButtonBase.js";
+import { DefaultFeatureFlags } from "../FeatureFlags/DefaultFeatureFlags.js";
+import { FeatureFlags } from "../FeatureFlags/FeatureFlags.js";
+import { useFeatureFlag } from "../FeatureFlags/useFeatureFlag.js";
 import { KeybindingHint } from "../KeybindingHint/KeybindingHint.js";
 import { getAccessibleKeybindingHintString } from "../KeybindingHint/utils.js";
 import { Tooltip } from "../TooltipV2/Tooltip.js";
 import { useOverflow } from "../hooks/useOverflow.js";
 import { ScrollableRegion } from "../ScrollableRegion/ScrollableRegion.js";
 import { Dialog } from "../Dialog/Dialog.js";
-import { DefaultFeatureFlags } from "../FeatureFlags/DefaultFeatureFlags.js";
-import { FeatureFlags } from "../FeatureFlags/FeatureFlags.js";
-import { useFeatureFlag } from "../FeatureFlags/useFeatureFlag.js";
 import { Stack } from "../Stack/index.js";
 import { SkeletonBox } from "../Skeleton/SkeletonBox.js";
 import { FilteredActionListLoadingTypes } from "../FilteredActionList/constants.js";
@@ -30,12 +30,12 @@ import { Table } from "../DataTable/index.js";
 import { InlineMessage } from "../InlineMessage/InlineMessage.js";
 import { Hidden } from "../Hidden/Hidden.js";
 import { SelectPanel } from "./SelectPanel2/SelectPanel.js";
-import UnderlinePanels_default from "./UnderlinePanels/UnderlinePanels.js";
-import { IssueLabel } from "./IssueLabel/IssueLabel.js";
 import { useTab } from "./Tabs/useTab.js";
 import { useTabList } from "./Tabs/useTabList.js";
 import { useTabPanel } from "./Tabs/useTabPanel.js";
 import { Tabs } from "./Tabs/Tabs.js";
+import UnderlinePanels_default from "./UnderlinePanels/UnderlinePanels.js";
+import { IssueLabel } from "./IssueLabel/IssueLabel.js";
 import { TopicTag } from "../TopicTag/index.js";
 //#region src/experimental/index.ts
 /**

package/dist/hooks/useMergedRefs.d.ts

@@ -17,18 +17,18 @@ import { ForwardedRef, Ref } from "react";
  * // React 18
  * const Example = forwardRef<HTMLButtonElement, {}>((props, forwardedRef) => {
  *  const ref = useRef<HTMLButtonElement>(null)
- *  const combinedRef = useMergedRefs(forwardedRef, ref)
+ *  const mergedRef = useMergedRefs(forwardedRef, ref)
  *
- *  return <button ref={combinedRef} />
+ *  return <button ref={mergedRef} />
  * })
  *
  * @example
  * // React 19
  * const Example = ({ref: externalRef}: {ref?: Ref<HTMLButtonElement>}) => {
  *  const ref = useRef<HTMLButtonElement>(null)
- *  const combinedRef = useMergedRefs(externalRef, ref)
+ *  const mergedRef = useMergedRefs(externalRef, ref)
  *
- *  return <button ref={combinedRef} />
+ *  return <button ref={mergedRef} />
  * }
  */
 declare function useMergedRefs<T>(refA: Ref$1<T | null>, refB: Ref$1<T | null>): (value: T | null) => (() => void) | undefined;

package/dist/hooks/useMergedRefs.js

@@ -1,7 +1,9 @@
 import { isExperimentalReactVersion, reactMajorVersion } from "../utils/environment.js";
 import { c } from "react-compiler-runtime";
-import "react";
+import { version } from "react";
 //#region src/hooks/useMergedRefs.ts
+var _version$split$;
+const majorReactVersion = parseInt((_version$split$ = version.split(".")[0]) !== null && _version$split$ !== void 0 ? _version$split$ : "18", 10);
 /**
 * Cleanup functions for refs were introduced in React 19. For feature detection,
 * we look to see if current version of React is >= 19 or if it is an
@@ -26,18 +28,18 @@ const supportsRefCleanup = reactMajorVersion >= 19 || isExperimentalReactVersion
 * // React 18
 * const Example = forwardRef<HTMLButtonElement, {}>((props, forwardedRef) => {
 *  const ref = useRef<HTMLButtonElement>(null)
-*  const combinedRef = useMergedRefs(forwardedRef, ref)
+*  const mergedRef = useMergedRefs(forwardedRef, ref)
 *
-*  return <button ref={combinedRef} />
+*  return <button ref={mergedRef} />
 * })
 *
 * @example
 * // React 19
 * const Example = ({ref: externalRef}: {ref?: Ref<HTMLButtonElement>}) => {
 *  const ref = useRef<HTMLButtonElement>(null)
-*  const combinedRef = useMergedRefs(externalRef, ref)
+*  const mergedRef = useMergedRefs(externalRef, ref)
 *
-*  return <button ref={combinedRef} />
+*  return <button ref={mergedRef} />
 * }
 */
 function useMergedRefs(refA, refB) {
@@ -48,6 +50,7 @@ function useMergedRefs(refA, refB) {
 			const cleanupA = setRef(refA, value);
 			const cleanupB = setRef(refB, value);
 			if (!supportsRefCleanup) return;
+			if (majorReactVersion <= 18) return;
 			return () => {
 				if (cleanupA) cleanupA();
 				else setRef(refA, null);

package/dist/hooks/useProvidedRefOrCreate.d.ts

@@ -9,17 +9,14 @@ import React from "react";
  * @param providedRef The ref to use - if undefined, will use the ref from a call to React.useRef
  * @type TRef The type of the RefObject which should be created.
  *
- * @deprecated This hook is incompatible with forwarded callback refs. Prefer `useMergedRefs` with an internally
- * created ref instead.
+ * @note This hook is overly restrictive in that it forces the provided ref to be a ref object rather than a callback.
+ * In particular, it should **not** be used to merge internal refs with forwarded refs. For this, use
+ * {@linkcode useMergedRefs} instead.
  *
- * ```diff
- * - const ref = useProvidedRefOrCreate(forwardedRef as RefObject<...>)
- * + const ref = useRef(null)
- * + const mergedRef = useMergedRefs(forwardedRef, ref)
- *
- * - return <div ref={ref} />
- * + return <div ref={mergedRef} />
- * ```
+ * The primary valid use case for this hook is for when the consumer is using the provided ref to point to an external
+ * element, like an externally rendered anchor. This is 'backwards' from forwarded refs with respect to data flow; the
+ * consumer is passing a reference to an external element, rather than passing a handle to obtain a reference to an
+ * internal element.
  */
 declare function useProvidedRefOrCreate<TRef>(providedRef?: React.RefObject<TRef | null>): React.RefObject<TRef | null>;
 //#endregion

package/dist/hooks/useProvidedRefOrCreate.js

@@ -8,17 +8,14 @@ import React from "react";
 * @param providedRef The ref to use - if undefined, will use the ref from a call to React.useRef
 * @type TRef The type of the RefObject which should be created.
 *
-* @deprecated This hook is incompatible with forwarded callback refs. Prefer `useMergedRefs` with an internally
-* created ref instead.
+* @note This hook is overly restrictive in that it forces the provided ref to be a ref object rather than a callback.
+* In particular, it should **not** be used to merge internal refs with forwarded refs. For this, use
+* {@linkcode useMergedRefs} instead.
 *
-* ```diff
-* - const ref = useProvidedRefOrCreate(forwardedRef as RefObject<...>)
-* + const ref = useRef(null)
-* + const mergedRef = useMergedRefs(forwardedRef, ref)
-*
-* - return <div ref={ref} />
-* + return <div ref={mergedRef} />
-* ```
+* The primary valid use case for this hook is for when the consumer is using the provided ref to point to an external
+* element, like an externally rendered anchor. This is 'backwards' from forwarded refs with respect to data flow; the
+* consumer is passing a reference to an external element, rather than passing a handle to obtain a reference to an
+* internal element.
 */
 function useProvidedRefOrCreate(providedRef) {
 	const createdRef = React.useRef(null);

package/generated/components.json

@@ -2656,11 +2656,18 @@
       ],
       "importPath": "@primer/react",
       "props": [
+        {
+          "name": "variant",
+          "type": "'primary' | 'secondary'",
+          "defaultValue": "",
+          "description": "Pass in 'primary' for a darker background and inverse text, or 'secondary' for a lighter background and primary text. Omitting the variant prop renders the default counter scheme"
+        },
         {
           "name": "scheme",
           "type": "'primary' | 'secondary'",
           "defaultValue": "",
-          "description": "Pass in 'primary' for a darker background and inverse text, or 'secondary' for a lighter background and primary text. Omitting the scheme prop renders the default counter scheme"
+          "description": "Use `variant` instead.",
+          "deprecated": true
         },
         {
           "name": "className",
@@ -5652,6 +5659,11 @@
               "type": "(event: MouseEvent | TouchEvent) => void",
               "description": "Callback fired when a click is detected outside the popover content"
             },
+            {
+              "name": "onEscape",
+              "type": "(event: KeyboardEvent) => void",
+              "description": "Callback fired when the Escape key is pressed while the popover is open"
+            },
             {
               "name": "ignoreClickRefs",
               "type": "React.RefObject<HTMLElement>[]",
@@ -7439,10 +7451,17 @@
       ],
       "importPath": "@primer/react",
       "props": [
+        {
+          "name": "size",
+          "type": "'small' | 'medium'",
+          "defaultValue": "'medium'"
+        },
         {
           "name": "variant",
           "type": "'small' | 'normal'",
-          "defaultValue": "'normal'"
+          "defaultValue": "'normal'",
+          "description": "Use `size` instead.",
+          "deprecated": true
         },
         {
           "name": "status",