@coinbase/cds-web 8.57.0 → 8.57.1

package/CHANGELOG.md

@@ -8,6 +8,12 @@ All notable changes to this project will be documented in this file.
 
 <!-- template-start -->
 
+## 8.57.1 (3/24/2026 PST)
+
+#### 🐞 Fixes
+
+- Use aria-describedby for all tooltip's triggers. [[#541](https://github.com/coinbase/cds/pull/541)]
+
 ## 8.57.0 (3/24/2026 PST)
 
 #### 🚀 Updates

package/dts/overlays/tooltip/Tooltip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../src/overlays/tooltip/Tooltip.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAQnD,eAAO,MAAM,OAAO,GAAI,+SAqBrB,YAAY,4CAoFd,CAAC"}
+{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../src/overlays/tooltip/Tooltip.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAQnD,eAAO,MAAM,OAAO,GAAI,+SAqBrB,YAAY,4CA8Ed,CAAC"}

package/dts/overlays/tooltip/TooltipContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TooltipContent.d.ts","sourceRoot":"","sources":["../../../src/overlays/tooltip/TooltipContent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AAmCzD,eAAO,MAAM,cAAc;;;wJAgD1B,CAAC"}
+{"version":3,"file":"TooltipContent.d.ts","sourceRoot":"","sources":["../../../src/overlays/tooltip/TooltipContent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AAmCzD,eAAO,MAAM,cAAc;;;wJAkD1B,CAAC"}

package/esm/overlays/tooltip/Tooltip.js

@@ -51,19 +51,13 @@ export const Tooltip = _ref => {
     }
   }, [handleOnMouseEnter]);
   const clonedChild = useMemo(() => {
-    const isStringContent = typeof content === 'string';
-    return /*#__PURE__*/cloneElement(children,
-    // String content: Use only aria-label so the trigger is announced on focus without
-    // double announcement (aria-describedby would point to the same text when the tooltip is open).
-    // Non-string content: Use only aria-describedby to associate the visible tooltip (id=tooltipId).
-    // We cannot use aria-label here (it accepts only strings). May not announce on focus for
-    // non-button triggers due to timing (describedby target mounts when tooltip opens).
-    isStringContent ? {
-      'aria-label': content
-    } : {
+    // Use aria-describedby to associate the tooltip (role="tooltip") with the trigger.
+    // This preserves the trigger's own accessible name (e.g. button text) while the tooltip
+    // provides supplemental description, per the ARIA tooltip pattern.
+    return /*#__PURE__*/cloneElement(children, {
       'aria-describedby': tooltipId
     });
-  }, [children, content, tooltipId]);
+  }, [children, tooltipId]);
   const contentPosition = useMemo(() => ({
     placement
   }), [placement]);

package/esm/overlays/tooltip/TooltipContent.js

@@ -46,17 +46,17 @@ export const TooltipContent = /*#__PURE__*/memo(/*#__PURE__*/forwardRef((_ref, r
       borderRadius: 200,
       "data-testid": testID,
       elevation: elevation,
+      id: tooltipId,
       maxWidth: tooltipMaxWidth,
       paddingX: tooltipPaddingX,
       paddingY: tooltipPaddingY,
+      role: "tooltip",
       children: typeof content === 'string' ? /*#__PURE__*/_jsx(Text, {
         className: textCss,
         color: "fg",
         font: "label2",
-        id: tooltipId,
         children: content
       }) : /*#__PURE__*/_jsx("div", {
-        id: tooltipId,
         children: content
       })
     })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinbase/cds-web",
-  "version": "8.57.0",
+  "version": "8.57.1",
   "description": "Coinbase Design System - Web",
   "repository": {
     "type": "git",
@@ -207,7 +207,7 @@
     "react-dom": "^18.3.1"
   },
   "dependencies": {
-    "@coinbase/cds-common": "^8.57.0",
+    "@coinbase/cds-common": "^8.57.1",
     "@coinbase/cds-icons": "^5.13.0",
     "@coinbase/cds-illustrations": "^4.35.0",
     "@coinbase/cds-lottie-files": "^3.3.4",