@coinbase/cds-common 8.55.0 → 8.56.0

package/CHANGELOG.md

@@ -8,6 +8,18 @@ All notable changes to this project will be documented in this file.
 
 <!-- template-start -->
 
+## 8.56.0 ((3/23/2026, 06:31 AM PST))
+
+This is an artificial version bump with no new change.
+
+#### 📘 Misc
+
+- Chore: Updated numerous deprecation annotation messages.
+
+## 8.55.1 ((3/22/2026, 01:43 PM PST))
+
+This is an artificial version bump with no new change.
+
 ## 8.55.0 ((3/19/2026, 01:41 PM PST))
 
 This is an artificial version bump with no new change.

package/dts/hooks/useGroupToggler.d.ts

@@ -18,7 +18,10 @@ export type GroupToggleState<T extends string> = {
     }
   ]
  */
-/** @deprecated Do not use this. */
+/**
+ * @deprecated Do not use this. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v9
+ */
 export declare const useGroupToggler: <T extends string>(
   values: T[],
   initialState?: T[],

package/dts/hooks/useGroupToggler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGroupToggler.d.ts","sourceRoot":"","sources":["../../src/hooks/useGroupToggler.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI;IAC/C,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC;CAClC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AAEH,mCAAmC;AACnC,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,MAAM,EAC9C,QAAQ,CAAC,EAAE,EACX,eAAe,CAAC,EAAE,KACjB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAwG9B,CAAC"}
+{"version":3,"file":"useGroupToggler.d.ts","sourceRoot":"","sources":["../../src/hooks/useGroupToggler.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI;IAC/C,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC;CAClC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,MAAM,EAC9C,QAAQ,CAAC,EAAE,EACX,eAAe,CAAC,EAAE,KACjB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAwG9B,CAAC"}

package/dts/hooks/useToggler.d.ts

@@ -1,4 +1,7 @@
-/** @deprecated Use React.useState instead. */
+/**
+ * @deprecated Use React.useState instead. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v9
+ */
 export declare function useToggler(initial?: boolean): [
   boolean,
   {

package/dts/hooks/useToggler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useToggler.d.ts","sourceRoot":"","sources":["../../src/hooks/useToggler.ts"],"names":[],"mappings":"AAEA,8CAA8C;AAC9C,wBAAgB,UAAU,CAAC,OAAO,UAAQ,GAAG;IAC3C,OAAO;IACP;QACE,QAAQ,EAAE,MAAM,IAAI,CAAC;QACrB,SAAS,EAAE,MAAM,IAAI,CAAC;QACtB,MAAM,EAAE,MAAM,IAAI,CAAC;KACpB;CACF,CAwBA"}
+{"version":3,"file":"useToggler.d.ts","sourceRoot":"","sources":["../../src/hooks/useToggler.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,UAAQ,GAAG;IAC3C,OAAO;IACP;QACE,QAAQ,EAAE,MAAM,IAAI,CAAC;QACrB,SAAS,EAAE,MAAM,IAAI,CAAC;QACtB,MAAM,EAAE,MAAM,IAAI,CAAC;KACpB;CACF,CAwBA"}

package/dts/overlays/useAlert.d.ts

@@ -1,5 +1,6 @@
 /**
- * @deprecated Use the visible and onRequestClose props as outlined in the docs here https://cds.coinbase.com/components/modal#get-started
+ * @deprecated Use the visible and onRequestClose props as outlined in the docs here https://cds.coinbase.com/components/modal#get-started. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v7
  */
 export declare const useAlert: () => {
   open: (content: import('./usePortalState').PortalNode['element']) => string;

package/dts/overlays/useAlert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAlert.d.ts","sourceRoot":"","sources":["../../src/overlays/useAlert.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,QAAQ;;;CAEpB,CAAC"}
+{"version":3,"file":"useAlert.d.ts","sourceRoot":"","sources":["../../src/overlays/useAlert.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;CAEpB,CAAC"}

package/dts/overlays/useModal.d.ts

@@ -1,5 +1,6 @@
 /**
- * @deprecated Use the visible and onRequestClose props as outlined in the docs here https://cds.coinbase.com/components/modal#get-started
+ * @deprecated Use the visible and onRequestClose props as outlined in the docs here https://cds.coinbase.com/components/modal#get-started. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v7
  */
 export declare const useModal: () => {
   openModal: (content: import('./usePortalState').PortalNode['element']) => string;

package/dts/overlays/useModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useModal.d.ts","sourceRoot":"","sources":["../../src/overlays/useModal.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,QAAQ;;;CAUpB,CAAC"}
+{"version":3,"file":"useModal.d.ts","sourceRoot":"","sources":["../../src/overlays/useModal.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;CAUpB,CAAC"}

package/dts/tokens/tags.d.ts

@@ -26,7 +26,8 @@ type TagColorMap = Record<
   >
 >;
 /**
- * @deprecated Use tagEmphasisColorMap instead
+ * @deprecated Use tagEmphasisColorMap instead. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v9
  */
 export declare const tagColorMap: TagColorMap;
 export {};

package/dts/tokens/tags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/tokens/tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEpF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,SAAS,CAGhD,CAAC;AAEX,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,KAAK,CAG1D,CAAC;AAEX,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,UAAU,CAG9D,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,YAAY,CAGxE,CAAC;AAEF,KAAK,mBAAmB,GAAG,MAAM,CAC/B,WAAW,EACX,MAAM,CACJ,cAAc,EACd;IAAE,UAAU,EAAE,SAAS,CAAC,aAAa,CAAC;IAAC,UAAU,EAAE,SAAS,CAAC,aAAa,CAAA;CAAE,CAC7E,CACF,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,mBAqDjC,CAAC;AAEF,KAAK,WAAW,GAAG,MAAM,CACvB,SAAS,EACT,MAAM,CACJ,cAAc,EACd;IAAE,UAAU,EAAE,SAAS,CAAC,aAAa,CAAC;IAAC,UAAU,EAAE,SAAS,CAAC,aAAa,CAAA;CAAE,CAC7E,CACF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,WAGzB,CAAC"}
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/tokens/tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEpF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,SAAS,CAGhD,CAAC;AAEX,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,KAAK,CAG1D,CAAC;AAEX,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,UAAU,CAG9D,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,YAAY,CAGxE,CAAC;AAEF,KAAK,mBAAmB,GAAG,MAAM,CAC/B,WAAW,EACX,MAAM,CACJ,cAAc,EACd;IAAE,UAAU,EAAE,SAAS,CAAC,aAAa,CAAC;IAAC,UAAU,EAAE,SAAS,CAAC,aAAa,CAAA;CAAE,CAC7E,CACF,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,mBAqDjC,CAAC;AAEF,KAAK,WAAW,GAAG,MAAM,CACvB,SAAS,EACT,MAAM,CACJ,cAAc,EACd;IAAE,UAAU,EAAE,SAAS,CAAC,aAAa,CAAC;IAAC,UAAU,EAAE,SAAS,CAAC,aAAa,CAAA;CAAE,CAC7E,CACF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,WAGzB,CAAC"}

package/dts/types/LottieStatusAnimationProps.d.ts

@@ -2,18 +2,21 @@ import type { DimensionValue } from './DimensionStyles';
 import type { LottieStatus } from './LottieStatus';
 import type { SharedProps } from './SharedProps';
 /**
- * @deprecated Use LottieStatus directly from @coinbase/cds-common/types/LottieStatus instead
+ * @deprecated Use LottieStatus directly from @coinbase/cds-common/types/LottieStatus instead. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v9
  */
 export type { LottieStatus as LottieStatusAnimationType };
 /**
- * @deprecated Use LottieStatusAnimationBaseProps from cds-web or cds-mobile instead
+ * @deprecated Use LottieStatusAnimationBaseProps from cds-web or cds-mobile instead. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v9
  */
 type BaseStatusAnimationProps = {
   status?: LottieStatus;
   onFinish?: () => void;
 };
 /**
- * @deprecated Use LottieStatusAnimationPropsWithWidth from cds-web or cds-mobile instead
+ * @deprecated Use LottieStatusAnimationPropsWithWidth from cds-web or cds-mobile instead. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v9
  */
 type LottieStatusAnimationPropsWithWidth = {
   /**
@@ -23,7 +26,8 @@ type LottieStatusAnimationPropsWithWidth = {
   width: DimensionValue;
 } & BaseStatusAnimationProps;
 /**
- * @deprecated Use LottieStatusAnimationPropsWithHeight from cds-web or cds-mobile instead
+ * @deprecated Use LottieStatusAnimationPropsWithHeight from cds-web or cds-mobile instead. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v9
  */
 type LottieStatusAnimationPropsWithHeight = {
   /**
@@ -33,7 +37,8 @@ type LottieStatusAnimationPropsWithHeight = {
   height: DimensionValue;
 } & BaseStatusAnimationProps;
 /**
- * @deprecated Use LottieStatusAnimationProps from cds-web or cds-mobile instead
+ * @deprecated Use LottieStatusAnimationProps from cds-web or cds-mobile instead. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v9
  */
 export type LottieStatusAnimationProps = (
   | LottieStatusAnimationPropsWithWidth

package/dts/types/LottieStatusAnimationProps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LottieStatusAnimationProps.d.ts","sourceRoot":"","sources":["../../src/types/LottieStatusAnimationProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;GAEG;AACH,YAAY,EAAE,YAAY,IAAI,yBAAyB,EAAE,CAAC;AAE1D;;GAEG;AACH,KAAK,wBAAwB,GAAG;IAC9B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,KAAK,mCAAmC,GAAG;IACzC;;;OAGG;IACH,KAAK,EAAE,cAAc,CAAC;CACvB,GAAG,wBAAwB,CAAC;AAE7B;;GAEG;AACH,KAAK,oCAAoC,GAAG;IAC1C;;;OAGG;IACH,MAAM,EAAE,cAAc,CAAC;CACxB,GAAG,wBAAwB,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACrC,mCAAmC,GACnC,oCAAoC,CACvC,GACC,WAAW,CAAC"}
+{"version":3,"file":"LottieStatusAnimationProps.d.ts","sourceRoot":"","sources":["../../src/types/LottieStatusAnimationProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;GAGG;AACH,YAAY,EAAE,YAAY,IAAI,yBAAyB,EAAE,CAAC;AAE1D;;;GAGG;AACH,KAAK,wBAAwB,GAAG;IAC9B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,KAAK,mCAAmC,GAAG;IACzC;;;OAGG;IACH,KAAK,EAAE,cAAc,CAAC;CACvB,GAAG,wBAAwB,CAAC;AAE7B;;;GAGG;AACH,KAAK,oCAAoC,GAAG;IAC1C;;;OAGG;IACH,MAAM,EAAE,cAAc,CAAC;CACxB,GAAG,wBAAwB,CAAC;AAE7B;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACrC,mCAAmC,GACnC,oCAAoC,CACvC,GACC,WAAW,CAAC"}

package/dts/types/StickyFooterProps.d.ts

@@ -2,7 +2,8 @@ import type { SharedAccessibilityProps } from './SharedAccessibilityProps';
 import type { SharedProps } from './SharedProps';
 import type { PaddingProps } from './SpacingProps';
 /**
- * @deprecated Use StickyFooterProps from @coinbase/cds-mobile instead.
+ * @deprecated Use StickyFooterProps from @coinbase/cds-mobile instead. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v8
  */
 export type StickyFooterProps = {
   /**

package/dts/types/StickyFooterProps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StickyFooterProps.d.ts","sourceRoot":"","sources":["../../src/types/StickyFooterProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC;CACvB,GAAG,WAAW,GACb,YAAY,GACZ,IAAI,CAAC,wBAAwB,EAAE,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"StickyFooterProps.d.ts","sourceRoot":"","sources":["../../src/types/StickyFooterProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC;CACvB,GAAG,WAAW,GACb,YAAY,GACZ,IAAI,CAAC,wBAAwB,EAAE,oBAAoB,CAAC,CAAC"}

package/esm/hooks/useGroupToggler.js

@@ -15,7 +15,10 @@ import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
   ]
  */
 
-/** @deprecated Do not use this. */
+/**
+ * @deprecated Do not use this. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v9
+ */
 export const useGroupToggler = (values, initialState) => {
   // The function inside useState will still run on every render.
   // This makes sure that we are not creating new Sets on every render

package/esm/hooks/useToggler.js

@@ -1,6 +1,9 @@
 import { useCallback, useMemo, useState } from 'react';
 
-/** @deprecated Use React.useState instead. */
+/**
+ * @deprecated Use React.useState instead. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v9
+ */
 export function useToggler() {
   let initial = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
   const [isToggled, setIsToggled] = useState(initial);

package/esm/overlays/useAlert.js

@@ -1,7 +1,8 @@
 import { useOverlay } from './useOverlay';
 
 /**
- * @deprecated Use the visible and onRequestClose props as outlined in the docs here https://cds.coinbase.com/components/modal#get-started
+ * @deprecated Use the visible and onRequestClose props as outlined in the docs here https://cds.coinbase.com/components/modal#get-started. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v7
  */
 export const useAlert = () => {
   return useOverlay('alert_');

package/esm/overlays/useModal.js

@@ -2,7 +2,8 @@ import { useMemo } from 'react';
 import { useOverlay } from './useOverlay';
 
 /**
- * @deprecated Use the visible and onRequestClose props as outlined in the docs here https://cds.coinbase.com/components/modal#get-started
+ * @deprecated Use the visible and onRequestClose props as outlined in the docs here https://cds.coinbase.com/components/modal#get-started. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v7
  */
 export const useModal = () => {
   const {

package/esm/tokens/tags.js

@@ -69,7 +69,8 @@ export const tagEmphasisColorMap = {
   }
 };
 /**
- * @deprecated Use tagEmphasisColorMap instead
+ * @deprecated Use tagEmphasisColorMap instead. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v9
  */
 export const tagColorMap = {
   informational: tagEmphasisColorMap.low,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinbase/cds-common",
-  "version": "8.55.0",
+  "version": "8.56.0",
   "description": "Coinbase Design System - Common",
   "repository": {
     "type": "git",
@@ -39,8 +39,8 @@
   },
   "dependencies": {
     "@coinbase/cds-icons": "^5.13.0",
-    "@coinbase/cds-illustrations": "^4.34.0",
-    "@coinbase/cds-mcp-server": "^8.55.0",
+    "@coinbase/cds-illustrations": "^4.35.0",
+    "@coinbase/cds-mcp-server": "^8.56.0",
     "@coinbase/cds-utils": "^2.3.5",
     "@modelcontextprotocol/sdk": "^1.13.1",
     "d3-array": "^3.2.4",