@coinbase/cds-common 8.66.2 → 9.0.0-rc.1

package/CHANGELOG.md

@@ -8,6 +8,12 @@ All notable changes to this project will be documented in this file.
 
 <!-- template-start -->
 
+## 9.0.0-rc.1 (4/28/2026 PST)
+
+#### 💥 Breaking
+
+- Feat: CDS 9 release candidate 1.
+
 ## 8.66.2 (4/28/2026 PST)
 
 #### 🐞 Fixes

package/dts/hooks/useFallbackShape.d.ts

@@ -3,12 +3,12 @@ export type UseFallbackShapeOptions = {
   disableRandomRectWidth?: boolean;
   rectWidthVariant?: number;
 };
-export declare function useFallbackShape(
+export declare function useFallbackShape<T = string | number>(
   shape: Shape,
-  baseWidth: number | string,
+  baseWidth: T,
   options?: UseFallbackShapeOptions,
 ): {
   borderRadius: number;
-  width: string | number;
+  width: number | T;
 };
 //# sourceMappingURL=useFallbackShape.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useFallbackShape.d.ts","sourceRoot":"","sources":["../../src/hooks/useFallbackShape.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAI5C,MAAM,MAAM,uBAAuB,GAAG;IACpC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,OAAO,CAAC,EAAE,uBAAuB;;;EAkClC"}
+{"version":3,"file":"useFallbackShape.d.ts","sourceRoot":"","sources":["../../src/hooks/useFallbackShape.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAI5C,MAAM,MAAM,uBAAuB,GAAG;IACpC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,EAClD,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,CAAC,EACZ,OAAO,CAAC,EAAE,uBAAuB;;;EAkClC"}

package/dts/hooks/useMergeRefs.d.ts

@@ -1,17 +1,6 @@
 /**
- * Merges multiple refs into a single ref callback. Supports both callback refs
- * and object refs. `null`/`undefined` refs are ignored.
- *
- * The returned callback is referentially stable across renders as long as the
- * underlying refs themselves are stable. This is critical under React 19,
- * which schedules a detach (`oldRef(null)`) followed by an attach
- * (`newRef(node)`) every time a ref-callback's identity changes. Without
- * `useCallback` here, every render would create a new merged callback,
- * triggering React 19's detach/attach lifecycle and — when one of the merged
- * refs synchronously sets state during attach/detach — an infinite update
- * loop ending in `Maximum update depth exceeded`.
+ * @deprecated Import from `@coinbase/cds-common/utils/mergeRefs` instead. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
  */
-export declare const useMergeRefs: <T = any>(
-  ...refs: (React.MutableRefObject<T> | React.LegacyRef<T> | undefined | null)[]
-) => React.RefCallback<T>;
+export { useMergeRefs } from '../utils/mergeRefs';
 //# sourceMappingURL=useMergeRefs.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useMergeRefs.d.ts","sourceRoot":"","sources":["../../src/hooks/useMergeRefs.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,GAAG,GAAG,EAClC,GAAG,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,KAC7E,KAAK,CAAC,WAAW,CAAC,CAAC,CAiBrB,CAAC"}
+{"version":3,"file":"useMergeRefs.d.ts","sourceRoot":"","sources":["../../src/hooks/useMergeRefs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dts/internal/utils/storyBuilder.d.ts

@@ -104,7 +104,7 @@ export declare const baseConfig: {
   };
   argTypes: {
     isDarkMode: {
-      control: string;
+      control: 'boolean';
       description: string;
     };
   };

package/dts/overlays/ToastProvider.d.ts

@@ -1,11 +1,6 @@
 import React from 'react';
 import type { ThemeVars } from '../core/theme';
-import type {
-  DimensionValue,
-  OverlayLifecycleProps,
-  SharedAccessibilityProps,
-  SharedProps,
-} from '../types';
+import type { OverlayLifecycleProps, SharedAccessibilityProps, SharedProps } from '../types';
 export type ToastRefHandle = {
   hide: () => Promise<boolean>;
 };
@@ -41,7 +36,7 @@ export type ToastBaseProps = SharedProps &
     /**
      * The vertical offset from the bottom of the screen
      */
-    bottomOffset?: DimensionValue;
+    bottomOffset?: string | number;
     /**
      * Controls color surge of the Toast background
      * @default primary

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

@@ -1 +1 @@
-{"version":3,"file":"ToastProvider.d.ts","sourceRoot":"","sources":["../../src/overlays/ToastProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+D,MAAM,OAAO,CAAC;AAEpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,WAAW,EACZ,MAAM,UAAU,CAAC;AAIlB,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG;IACtC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,WAAW,GACtC,wBAAwB,GACxB,IAAI,CAAC,qBAAqB,EAAE,YAAY,GAAG,WAAW,CAAC,GAAG;IACxD;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC;CAC3B,CAAC;AAEJ,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC,cAAc,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;CAAE,CAAC,CAAC;AAEpG;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACpE,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,YAAY,oCAQvB,CAAC;AAEH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAsC/E,CAAC"}
+{"version":3,"file":"ToastProvider.d.ts","sourceRoot":"","sources":["../../src/overlays/ToastProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+D,MAAM,OAAO,CAAC;AAEpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAI7F,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG;IACtC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,WAAW,GACtC,wBAAwB,GACxB,IAAI,CAAC,qBAAqB,EAAE,YAAY,GAAG,WAAW,CAAC,GAAG;IACxD;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC;CAC3B,CAAC;AAEJ,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC,cAAc,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;CAAE,CAAC,CAAC;AAEpG;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACpE,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,YAAY,oCAQvB,CAAC;AAEH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAsC/E,CAAC"}

package/dts/overlays/useAlert.d.ts

@@ -1,5 +1,5 @@
 /**
- * @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.
+ * @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: () => {

package/dts/overlays/useModal.d.ts

@@ -1,5 +1,5 @@
 /**
- * @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.
+ * @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: () => {

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

@@ -1 +1 @@
-{"version":3,"file":"useToastQueue.d.ts","sourceRoot":"","sources":["../../src/overlays/useToastQueue.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,iBAAiB,CAAC;AAEjE,eAAO,MAAM,aAAa;;wBAoCZ,SAAS,CAAC,SAAS,CAAC,YAAY,MAAM;;;;;;CAgCnD,CAAC"}
+{"version":3,"file":"useToastQueue.d.ts","sourceRoot":"","sources":["../../src/overlays/useToastQueue.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,iBAAiB,CAAC;AAEjE,eAAO,MAAM,aAAa;;wBAsCZ,SAAS,CAAC,SAAS,CAAC,YAAY,MAAM;;;;;;CAgCnD,CAAC"}

package/dts/svg/shape.d.ts

@@ -0,0 +1,3 @@
+export declare const hexagonShapePath =
+  'M15.4855 6.0242C16.1715 7.24852 16.1715 8.75148 15.4855 9.97581L13.4213 13.6598C12.7259 14.9008 11.4317 15.6667 10.0301 15.6667H5.96994C4.56828 15.6667 3.2741 14.9008 2.57874 13.6598L0.514515 9.97581C-0.171504 8.75148 -0.171505 7.24852 0.514514 6.0242L2.57874 2.34022C3.2741 1.09922 4.56828 0.333336 5.96994 0.333336H10.0301C11.4317 0.333336 12.7259 1.09922 13.4213 2.34022L15.4855 6.0242Z';
+//# sourceMappingURL=shape.d.ts.map

package/dts/svg/shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.d.ts","sourceRoot":"","sources":["../../src/svg/shape.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,0YAC4W,CAAC"}

package/dts/tokens/button.d.ts

@@ -10,9 +10,9 @@ export declare const variants: {
     readonly borderColor: 'bgSecondary';
   };
   readonly tertiary: {
-    readonly color: 'fgInverse';
-    readonly background: 'bgInverse';
-    readonly borderColor: 'bgInverse';
+    readonly color: 'fg';
+    readonly background: 'bgTertiary';
+    readonly borderColor: 'bgTertiary';
   };
   readonly foregroundMuted: {
     readonly color: 'fgMuted';
@@ -29,6 +29,11 @@ export declare const variants: {
     readonly background: 'bgNegative';
     readonly borderColor: 'bgNegative';
   };
+  readonly inverse: {
+    readonly color: 'fgInverse';
+    readonly background: 'bgInverse';
+    readonly borderColor: 'bgInverse';
+  };
 };
 export declare const transparentVariants: {
   readonly primary: {
@@ -61,5 +66,10 @@ export declare const transparentVariants: {
     readonly background: 'bg';
     readonly borderColor: 'transparent';
   };
+  readonly inverse: {
+    readonly color: 'fg';
+    readonly background: 'bg';
+    readonly borderColor: 'transparent';
+  };
 };
 //# sourceMappingURL=button.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../src/tokens/button.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BmB,CAAC;AAEzC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BQ,CAAC"}
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../src/tokens/button.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCmB,CAAC;AAEzC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCQ,CAAC"}

package/dts/tokens/cell.d.ts

@@ -2,7 +2,15 @@ import type { IconName, ThemeVars } from '..';
 export declare const mediaSize = 32;
 export declare const imageSize = 48;
 export declare const pictogramScaleMultiplier = 1;
+/**
+ * @deprecated This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ * */
 export declare const listHeight = 80;
+/**
+ * @deprecated This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ * */
 export declare const compactListHeight = 40;
 /** Spacing configs for Cells to be parsed in [web/mobile]/hooks/useCellSpacing */
 /** Default spacing config */
@@ -18,6 +26,10 @@ export declare const defaultSpacingConfig: {
     readonly marginX: 0;
   };
 };
+/**
+ * @deprecated Used by deprecated Select component. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ */
 export declare const selectOptionHeight = 56;
 export declare const cellPriorities: readonly ['start', 'middle', 'end'];
 export declare const cellHelperTextVariants: Record<

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

@@ -1 +1 @@
-{"version":3,"file":"cell.d.ts","sourceRoot":"","sources":["../../src/tokens/cell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAI9C,eAAO,MAAM,SAAS,KAAK,CAAC;AAG5B,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,kFAAkF;AAElF,6BAA6B;AAC7B,eAAO,MAAM,oBAAoB;;;;;;;;;;;CAWvB,CAAC;AAEX,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,eAAO,MAAM,cAAc,qCAAsC,CAAC;AAElE,eAAO,MAAM,sBAAsB,EAAE,MAAM,CACzC,aAAa,GAAG,SAAS,GAAG,OAAO,EACnC;IACE,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC;CACxB,CAcF,CAAC"}
+{"version":3,"file":"cell.d.ts","sourceRoot":"","sources":["../../src/tokens/cell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAI9C,eAAO,MAAM,SAAS,KAAK,CAAC;AAG5B,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;;KAGK;AACL,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B;;;KAGK;AACL,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,kFAAkF;AAElF,6BAA6B;AAC7B,eAAO,MAAM,oBAAoB;;;;;;;;;;;CAWvB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,eAAO,MAAM,cAAc,qCAAsC,CAAC;AAElE,eAAO,MAAM,sBAAsB,EAAE,MAAM,CACzC,aAAa,GAAG,SAAS,GAAG,OAAO,EACnC;IACE,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC;CACxB,CAcF,CAAC"}

package/dts/tokens/dot.d.ts

@@ -2,11 +2,25 @@ import type { DotSize } from '../types';
 import type { AvatarSize } from '../types/AvatarSize';
 export declare const avatarIconSizeMap: Record<AvatarSize, DotSize>;
 export declare const avatarDotSizeMap: Record<AvatarSize, DotSize>;
+/**
+ * The fixed height of the DotCount component.
+ * Width grows based on content length.
+ **/
 export declare const dotCountSize = 24;
+/**
+ * @deprecated Use local sizing logic instead. This export is temporarily supported for
+ * compatibility. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ */
 export declare const dotSizeTokens: {
   readonly s: 28;
   readonly m: 36;
-  readonly l: 42;
+  readonly l: 48;
 };
-export declare const getDotSize: (count?: number) => 28 | 36 | 42;
+/**
+ * @deprecated Use local sizing logic instead. This export is temporarily supported for
+ * compatibility. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ */
+export declare const getDotSize: (count?: number) => 48 | 28 | 36;
 //# sourceMappingURL=dot.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"dot.d.ts","sourceRoot":"","sources":["../../src/tokens/dot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,CAOhD,CAAC;AAEX,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,CAO/C,CAAC;AAEX,eAAO,MAAM,YAAY,KAAK,CAAC;AAI/B,eAAO,MAAM,aAAa;;;;CAAmC,CAAC;AAC9D,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,iBAMxC,CAAC"}
+{"version":3,"file":"dot.d.ts","sourceRoot":"","sources":["../../src/tokens/dot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,CAOhD,CAAC;AAEX,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,CAO/C,CAAC;AAEX;;;IAGI;AACJ,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;CAAmC,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,iBAMxC,CAAC"}

package/dts/tour/TourContext.d.ts

@@ -1,8 +1,12 @@
 import { type Context } from 'react';
 import type { TourApi } from './useTour';
-export type TourContextValue<TourStepId extends string = string> = TourApi<TourStepId>;
-export declare const TourContext: Context<TourContextValue<string> | undefined>;
+export type TourContextValue<TourStepId extends string = string, TTarget = unknown> = TourApi<
+  TourStepId,
+  TTarget
+>;
+export declare const TourContext: Context<TourContextValue<string, unknown> | undefined>;
 export declare const useTourContext: <
   TourStepId extends string = string,
->() => TourContextValue<TourStepId>;
+  TTarget = unknown,
+>() => TourContextValue<TourStepId, TTarget>;
 //# sourceMappingURL=TourContext.d.ts.map

package/dts/tour/TourContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TourContext.d.ts","sourceRoot":"","sources":["../../src/tour/TourContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAA6B,MAAM,OAAO,CAAC;AAEhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,MAAM,gBAAgB,CAAC,UAAU,SAAS,MAAM,GAAG,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;AAEvF,eAAO,MAAM,WAAW,+CAAyD,CAAC;AAElF,eAAO,MAAM,cAAc,GACzB,UAAU,SAAS,MAAM,GAAG,MAAM,OAC/B,gBAAgB,CAAC,UAAU,CAI/B,CAAC"}
+{"version":3,"file":"TourContext.d.ts","sourceRoot":"","sources":["../../src/tour/TourContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAA6B,MAAM,OAAO,CAAC;AAEhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,MAAM,gBAAgB,CAAC,UAAU,SAAS,MAAM,GAAG,MAAM,EAAE,OAAO,GAAG,OAAO,IAAI,OAAO,CAC3F,UAAU,EACV,OAAO,CACR,CAAC;AAEF,eAAO,MAAM,WAAW,wDAAyD,CAAC;AAElF,eAAO,MAAM,cAAc,GACzB,UAAU,SAAS,MAAM,GAAG,MAAM,EAClC,OAAO,GAAG,OAAO,OACd,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAMxC,CAAC"}

package/dts/tour/useTour.d.ts

@@ -1,19 +1,45 @@
 import type React from 'react';
-import type { View } from 'react-native';
-import { type Coords, type Placement } from '@floating-ui/react-dom';
+/**
+ * Placement for the tour step arrow. Matches the placement values used by positioning libraries
+ * (e.g. @floating-ui) so web/mobile can pass through their placement directly.
+ */
+export type TourStepArrowPlacement =
+  | 'top'
+  | 'top-start'
+  | 'top-end'
+  | 'right'
+  | 'right-start'
+  | 'right-end'
+  | 'bottom'
+  | 'bottom-start'
+  | 'bottom-end'
+  | 'left'
+  | 'left-start'
+  | 'left-end';
+/**
+ * Arrow coordinates and offsets for the tour step arrow. Matches the shape provided by arrow
+ * middleware (e.g. @floating-ui) so web/mobile can pass through their arrow data directly.
+ */
+export type TourStepArrowData = {
+  x?: number;
+  y?: number;
+  centerOffset?: number;
+  alignmentOffset?: number;
+};
 /**
  * @deprecated Import from `@coinbase/cds-web` or `@coinbase/cds-mobile` instead. This will be removed in a future major release.
  * @deprecationExpectedRemoval v10
  */
 export type TourStepArrowComponentProps = {
-  arrow?: Partial<Coords> & {
-    centerOffset: number;
-    alignmentOffset?: number;
-  };
-  placement: Placement;
+  /** Arrow coordinates and offsets for positioning the arrow element. */
+  arrow?: TourStepArrowData;
+  /** Placement of the arrow relative to the floating element. */
+  placement: TourStepArrowPlacement;
   style?: Record<string, string | number>;
 };
 /**
+ * The TourStepArrowComponent forwards a ref to the underlying element.
+ * This is required for the positioning library to work correctly.
  * @deprecated Import from `@coinbase/cds-web` or `@coinbase/cds-mobile` instead. This will be removed in a future major release.
  * @deprecationExpectedRemoval v10
  */
@@ -93,12 +119,19 @@ export type TourOptions<TourStepId extends string = string> = {
   activeTourStep: TourStepValue<TourStepId> | null;
   onChange: (tourStep: TourStepValue<TourStepId> | null) => void;
 };
-export type TourApi<TourStepId extends string = string> = Omit<
+/**
+ * API returned by useTour and provided via TourContext.
+ * @template TourStepId - Step id string literal type.
+ * @template TTarget - Type of the active step's target element (e.g. HTMLElement for web, View for react-native). Defaults to unknown.
+ */
+export type TourApi<TourStepId extends string = string, TTarget = unknown> = Omit<
   TourOptions<TourStepId>,
   'onChange'
 > & {
-  activeTourStepTarget: HTMLElement | View | null;
-  setActiveTourStepTarget: (target: HTMLElement | View | null) => void;
+  /** The target element of the currently active tour step. */
+  activeTourStepTarget: TTarget | null;
+  /** Set the target element of the currently active tour step. */
+  setActiveTourStepTarget: (target: TTarget | null) => void;
   setActiveTourStep: (tourStepId: TourStepId | null) => void;
   startTour: (tourStepId?: TourStepId) => void;
   stopTour: () => void;
@@ -109,9 +142,9 @@ export type TourApi<TourStepId extends string = string> = Omit<
  * A controlled hook for managing tour state, such as the currently active tour step.
  * @see {@link https://linear.app/coinbase/issue/CDS-1878 CDS-1878} for planned refactor to make this API platform agnostic.
  */
-export declare const useTour: <TourStepId extends string = string>({
+export declare const useTour: <TourStepId extends string = string, TTarget = unknown>({
   steps,
   activeTourStep,
   onChange,
-}: TourOptions<TourStepId>) => TourApi<TourStepId>;
+}: TourOptions<TourStepId>) => TourApi<TourStepId, TTarget>;
 //# sourceMappingURL=useTour.d.ts.map

package/dts/tour/useTour.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTour.d.ts","sourceRoot":"","sources":["../../src/tour/useTour.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useTour.d.ts","sourceRoot":"","sources":["../../src/tour/useTour.ts"],"names":[],"mappings":"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"}

package/dts/types/BoxBaseProps.d.ts

@@ -58,6 +58,10 @@ export type FlexStyles = {
     | 'space-evenly';
 };
 export type PinningDirection = 'top' | 'bottom' | 'left' | 'right' | 'all';
+/**
+ * @deprecated Use PositionStyles type in mobile/src/styles/styleProps.ts instead. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ */
 export type PositionStyles = {
   /** Position the box to the bottom edge. */
   bottom?: DimensionValue;

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

@@ -1 +1 @@
-{"version":3,"file":"BoxBaseProps.d.ts","sourceRoot":"","sources":["../../src/types/BoxBaseProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,SAAS,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,cAAc,CAAC;AAC/D,MAAM,MAAM,UAAU,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,MAAM,MAAM,UAAU,GAAG;IACvB;;;OAGG;IACH,YAAY,CAAC,EACT,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,SAAS,GACT,eAAe,GACf,cAAc,GACd,cAAc,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IAC3E;;;OAGG;IACH,SAAS,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IACnF,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,yDAAyD;IACzD,aAAa,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,aAAa,GAAG,gBAAgB,CAAC;IACpE,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,cAAc,CAAC;IAC9C;;;OAGG;IACH,cAAc,CAAC,EACX,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,eAAe,GACf,cAAc,GACd,cAAc,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAE3E,MAAM,MAAM,cAAc,GAAG;IAC3B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,yCAAyC;IACzC,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,wCAAwC;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}
+{"version":3,"file":"BoxBaseProps.d.ts","sourceRoot":"","sources":["../../src/types/BoxBaseProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,SAAS,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,cAAc,CAAC;AAC/D,MAAM,MAAM,UAAU,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,MAAM,MAAM,UAAU,GAAG;IACvB;;;OAGG;IACH,YAAY,CAAC,EACT,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,SAAS,GACT,eAAe,GACf,cAAc,GACd,cAAc,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IAC3E;;;OAGG;IACH,SAAS,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IACnF,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,yDAAyD;IACzD,aAAa,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,aAAa,GAAG,gBAAgB,CAAC;IACpE,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,cAAc,CAAC;IAC9C;;;OAGG;IACH,cAAc,CAAC,EACX,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,eAAe,GACf,cAAc,GACd,cAAc,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAE3E;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,yCAAyC;IACzC,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,wCAAwC;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/dts/types/ButtonBaseProps.d.ts

@@ -4,5 +4,9 @@ export type ButtonVariant =
   | 'tertiary'
   | 'positive'
   | 'negative'
-  | 'foregroundMuted';
+  /**
+   * @deprecated Use `secondary` directly. `foregroundMuted` is temporarily supported for compatibility and will be removed in a future release.
+   */
+  | 'foregroundMuted'
+  | 'inverse';
 //# sourceMappingURL=ButtonBaseProps.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ButtonBaseProps.d.ts","sourceRoot":"","sources":["../../src/types/ButtonBaseProps.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,WAAW,GACX,UAAU,GACV,UAAU,GACV,UAAU,GACV,iBAAiB,CAAC"}
+{"version":3,"file":"ButtonBaseProps.d.ts","sourceRoot":"","sources":["../../src/types/ButtonBaseProps.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,WAAW,GACX,UAAU,GACV,UAAU,GACV,UAAU;AACZ;;GAEG;GACD,iBAAiB,GACjB,SAAS,CAAC"}

package/dts/types/DimensionStyles.d.ts

@@ -1,7 +1,23 @@
+/**
+ * @deprecated Use the dimension props (e.g. `width`, `height`) directly with values of type `'auto' | number | string`. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ */
 export type FixedValue = number | string;
+/**
+ * @deprecated Use the dimension props (e.g. `width`, `height`) directly with values of type `'auto' | number | string`. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ */
 export type PercentageValue = string;
+/**
+ * @deprecated Use the dimension props (e.g. `width`, `height`) directly with values of type `'auto' | number | string`. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ */
 export type DimensionValue = 'auto' | FixedValue | PercentageValue;
 export type ResizeMode = 'cover' | 'contain';
+/**
+ * @deprecated Use the dimension props (e.g. `width`, `height`) directly with values of type `'auto' | number | string`. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ */
 export type DimensionStyles = {
   /** Set a fixed height. */
   height?: DimensionValue;

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

@@ -1 +1 @@
-{"version":3,"file":"DimensionStyles.d.ts","sourceRoot":"","sources":["../../src/types/DimensionStyles.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AACzC,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AACrC,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,CAAC;AACnE,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAE7C,MAAM,MAAM,eAAe,GAAG;IAC5B,0BAA0B;IAC1B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,yBAAyB;IACzB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;CAClD,CAAC"}
+{"version":3,"file":"DimensionStyles.d.ts","sourceRoot":"","sources":["../../src/types/DimensionStyles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AACzC;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AACrC;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,CAAC;AACnE,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,0BAA0B;IAC1B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,yBAAyB;IACzB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;CAClD,CAAC"}

package/dts/types/Position.d.ts

@@ -1,2 +1,6 @@
+/**
+ * @deprecated Use the CSSProperties['position'] or ViewStyle['position'] instead. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ */
 export type Position = 'static' | 'relative' | 'fixed' | 'absolute' | 'sticky';
 //# sourceMappingURL=Position.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Position.d.ts","sourceRoot":"","sources":["../../src/types/Position.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"Position.d.ts","sourceRoot":"","sources":["../../src/types/Position.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC"}

package/dts/types/index.d.ts

@@ -48,7 +48,6 @@ export * from './SharedProps';
 export * from './SpacingProps';
 export * from './SparklineInteractiveHeaderBaseProps';
 export * from './SpreadPropsSafely';
-export * from './StickyFooterProps';
 export * from './TagBaseProps';
 export * from './TextBaseProps';
 export * from './TooltipBaseProps';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,wBAAwB,CAAC;AACvC,cAAc,SAAS,CAAC;AACxB,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,UAAU,CAAC;AACzB,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,qCAAqC,CAAC;AACpD,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uCAAuC,CAAC;AACtD,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,wBAAwB,CAAC;AACvC,cAAc,SAAS,CAAC;AACxB,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,UAAU,CAAC;AACzB,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,qCAAqC,CAAC;AACpD,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uCAAuC,CAAC;AACtD,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC"}

package/dts/utils/flattenNodes.d.ts

@@ -1,9 +1,8 @@
-type Child = string | number | React.ReactElement<any, string | React.JSXElementConstructor<any>>;
-export declare function hasProps(child: Child): child is React.ReactElement;
+type FlattenedNode = React.ReactElement | string | number;
 export default function flattenNodes(
   children: React.ReactNode,
   depth?: number,
   keys?: (string | number)[],
-): Child[];
+): FlattenedNode[];
 export {};
 //# sourceMappingURL=flattenNodes.d.ts.map

package/dts/utils/flattenNodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flattenNodes.d.ts","sourceRoot":"","sources":["../../src/utils/flattenNodes.ts"],"names":[],"mappings":"AASA,KAAK,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;AAGlG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,IAAI,KAAK,CAAC,YAAY,CAElE;AAGD,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,QAAQ,EAAE,KAAK,CAAC,SAAS,EACzB,KAAK,SAAI,EACT,IAAI,GAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAO,GAC7B,KAAK,EAAE,CA4BT"}
+{"version":3,"file":"flattenNodes.d.ts","sourceRoot":"","sources":["../../src/utils/flattenNodes.ts"],"names":[],"mappings":"AAUA,KAAK,aAAa,GAAG,KAAK,CAAC,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAG1D,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,QAAQ,EAAE,KAAK,CAAC,SAAS,EACzB,KAAK,SAAI,EACT,IAAI,GAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAO,GAC7B,aAAa,EAAE,CA0BjB"}

package/dts/utils/getButtonSpacingProps.d.ts

@@ -11,6 +11,10 @@ type ButtonSpacingValue = {
   marginEnd?: NegativeSpace;
   marginStart?: NegativeSpace;
 };
+/**
+ * @deprecated This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ */
 export declare const getButtonSpacingProps: ({
   compact,
   flush,

package/dts/utils/getButtonSpacingProps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getButtonSpacingProps.d.ts","sourceRoot":"","sources":["../../src/utils/getButtonSpacingProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAa9C,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC;CACnC,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC;IAC3B,QAAQ,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC;IAC3B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,qBAGnC,sBAAsB,KAAG,kBAW3B,CAAC"}
+{"version":3,"file":"getButtonSpacingProps.d.ts","sourceRoot":"","sources":["../../src/utils/getButtonSpacingProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAa9C,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC;CACnC,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC;IAC3B,QAAQ,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC;IAC3B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,qBAGnC,sBAAsB,KAAG,kBAY3B,CAAC"}

package/dts/utils/mergeRefs.d.ts

@@ -0,0 +1,28 @@
+import type React from 'react';
+type OptionalRef<T> = React.Ref<T> | undefined;
+/**
+ * Merge multiple refs into a single ref callback.
+ *
+ * - Supports callback refs and object refs.
+ * - Ignores `null`/`undefined` refs.
+ * - Intentionally does not support legacy string refs.
+ */
+export declare const mergeRefs: <T = unknown>(...refs: OptionalRef<T>[]) => React.RefCallback<T>;
+/**
+ * Like `mergeRefs`, but also includes an existing ref already present on a React element.
+ *
+ * This is React 18/19 compatible:
+ * - React 19 stores refs on `element.props.ref`
+ * - React 18 and earlier store refs on `element.ref`
+ */
+export declare const mergeReactElementRef: <T = unknown>(
+  element: React.ReactElement,
+  ...refs: OptionalRef<T>[]
+) => React.RefCallback<T>;
+/**
+ * @deprecated Prefer `mergeRefs` function instead. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ */
+export declare const useMergeRefs: <T = unknown>(...refs: OptionalRef<T>[]) => React.RefCallback<T>;
+export {};
+//# sourceMappingURL=mergeRefs.d.ts.map

package/dts/utils/mergeRefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeRefs.d.ts","sourceRoot":"","sources":["../../src/utils/mergeRefs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,KAAK,WAAW,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;AAoB/C;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,GAAG,OAAO,EAAE,GAAG,MAAM,WAAW,CAAC,CAAC,CAAC,EAAE,KAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAUrF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,GAAG,OAAO,EAC9C,SAAS,KAAK,CAAC,YAAY,EAC3B,GAAG,MAAM,WAAW,CAAC,CAAC,CAAC,EAAE,KACxB,KAAK,CAAC,WAAW,CAAC,CAAC,CAGrB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,GAAG,OAAO,EAAE,GAAG,MAAM,WAAW,CAAC,CAAC,CAAC,EAAE,KAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAsBxF,CAAC"}

package/dts/visualizations/useVisualizationDimensions.d.ts

@@ -1,16 +1,17 @@
-import type { DimensionValue } from '../types';
-type VisualizationDimensions = {
-  userDefinedWidth: DimensionValue;
-  userDefinedHeight: DimensionValue;
+type VisualizationDimensions<DimensionType> = {
+  userDefinedWidth: DimensionType;
+  userDefinedHeight: DimensionType;
   calculatedWidth: number;
   calculatedHeight: number;
 };
-export declare const useVisualizationDimensions: ({
+export declare const useVisualizationDimensions: <
+  DimensionType = string | number | undefined | null,
+>({
   userDefinedWidth,
   userDefinedHeight,
   calculatedWidth,
   calculatedHeight,
-}: VisualizationDimensions) => {
+}: VisualizationDimensions<DimensionType>) => {
   width: number;
   height: number;
   circleSize: number;

package/dts/visualizations/useVisualizationDimensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useVisualizationDimensions.d.ts","sourceRoot":"","sources":["../../src/visualizations/useVisualizationDimensions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,KAAK,uBAAuB,GAAG;IAC7B,gBAAgB,EAAE,cAAc,CAAC;IACjC,iBAAiB,EAAE,cAAc,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,6EAKxC,uBAAuB;;;;;CAqBzB,CAAC"}
+{"version":3,"file":"useVisualizationDimensions.d.ts","sourceRoot":"","sources":["../../src/visualizations/useVisualizationDimensions.ts"],"names":[],"mappings":"AAEA,KAAK,uBAAuB,CAAC,aAAa,IAAI;IAC5C,gBAAgB,EAAE,aAAa,CAAC;IAChC,iBAAiB,EAAE,aAAa,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,6EAK5F,uBAAuB,CAAC,aAAa,CAAC;;;;;CAqBxC,CAAC"}

package/esm/hooks/useGroupToggler.js

@@ -25,7 +25,7 @@ export const useGroupToggler = (values, initialState) => {
   // and just throwing it away immediately.
   const initialStateSet = useMemo(() => new Set(initialState), [initialState]);
   const [state, setState] = useState(initialStateSet);
-  const lastMixedStateRef = useRef();
+  const lastMixedStateRef = useRef(undefined);
   useEffect(() => {
     const isStateMixed = state.size !== 0 && state.size !== values.length;
     if (isStateMixed) {

package/esm/hooks/useMergeRefs.js

@@ -1,34 +1,5 @@
-import { useCallback } from 'react';
-
 /**
- * Merges multiple refs into a single ref callback. Supports both callback refs
- * and object refs. `null`/`undefined` refs are ignored.
- *
- * The returned callback is referentially stable across renders as long as the
- * underlying refs themselves are stable. This is critical under React 19,
- * which schedules a detach (`oldRef(null)`) followed by an attach
- * (`newRef(node)`) every time a ref-callback's identity changes. Without
- * `useCallback` here, every render would create a new merged callback,
- * triggering React 19's detach/attach lifecycle and — when one of the merged
- * refs synchronously sets state during attach/detach — an infinite update
- * loop ending in `Maximum update depth exceeded`.
+ * @deprecated Import from `@coinbase/cds-common/utils/mergeRefs` instead. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
  */
-export const useMergeRefs = function () {
-  for (var _len = arguments.length, refs = new Array(_len), _key = 0; _key < _len; _key++) {
-    refs[_key] = arguments[_key];
-  }
-  return useCallback(value => {
-    refs.forEach(ref => {
-      if (typeof ref === 'function') {
-        ref(value);
-      } else if (ref != null) {
-        ref.current = value;
-      }
-    });
-  },
-  // The deps are the spread refs themselves. React's `useCallback` shallow-
-  // compares each element of the deps array, so the returned callback stays
-  // stable when each underlying ref keeps the same identity across renders.
-  // eslint-disable-next-line react-hooks/exhaustive-deps
-  refs);
-};
+export { useMergeRefs } from '../utils/mergeRefs';

package/esm/hooks/usePreviousValue.js

@@ -2,7 +2,7 @@ import { useEffect, useRef } from 'react';
 export const usePreviousValue = value => {
   // The ref object is a generic container whose current property is mutable ...
   // ... and can hold any value, similar to an instance property on a class
-  const ref = useRef();
+  const ref = useRef(undefined);
   // Store current value in ref
   useEffect(() => {
     ref.current = value;

package/esm/hooks/useTimer.js

@@ -2,10 +2,10 @@ import { useCallback, useEffect, useMemo, useRef } from 'react';
 
 // Timer for single execution
 export const useTimer = () => {
-  const timerRef = useRef();
+  const timerRef = useRef(undefined);
   const startTimeRef = useRef(0);
   const remainingTimeRef = useRef(0);
-  const callbackRef = useRef();
+  const callbackRef = useRef(undefined);
   const isPausedRef = useRef(false);
   const clear = useCallback(() => {
     if (timerRef.current) {

package/esm/lottie/useStatusAnimationPoller.js

@@ -17,7 +17,7 @@ export const useStatusAnimationPoller = _ref => {
       isRunning.current = true;
     }
   }, [playMarkers]);
-  const previousStatusRef = useRef();
+  const previousStatusRef = useRef(undefined);
 
   // onAnimationFinish will get triggered after our first useEffect
   // play completes and then after each play within onAnimationFinish completes.

package/esm/overlays/useAlert.js

@@ -1,7 +1,7 @@
 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. This will be removed in a future major release.
+ * @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 = () => {

package/esm/overlays/useModal.js

@@ -2,7 +2,7 @@ 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. This will be removed in a future major release.
+ * @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 = () => {

package/esm/overlays/useToastQueue.js

@@ -5,6 +5,7 @@ function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol"
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { cloneElement, useCallback, useEffect, useRef, useState } from 'react';
 import { useTimer } from '../hooks/useTimer';
+import { mergeReactElementRef } from '../utils/mergeRefs';
 export const useToastQueue = () => {
   const [activeToast, setActiveToast] = useState();
   const toastQueue = useRef([]);
@@ -25,7 +26,7 @@ export const useToastQueue = () => {
     activeToastRef.current = null;
     setActiveToast(_objectSpread(_objectSpread({}, toast), {}, {
       element: /*#__PURE__*/cloneElement(toast.element, {
-        ref: activeToastRef
+        ref: mergeReactElementRef(toast.element, activeToastRef)
       })
     }));
 

package/esm/svg/shape.js

@@ -0,0 +1 @@
+export const hexagonShapePath = 'M15.4855 6.0242C16.1715 7.24852 16.1715 8.75148 15.4855 9.97581L13.4213 13.6598C12.7259 14.9008 11.4317 15.6667 10.0301 15.6667H5.96994C4.56828 15.6667 3.2741 14.9008 2.57874 13.6598L0.514515 9.97581C-0.171504 8.75148 -0.171505 7.24852 0.514514 6.0242L2.57874 2.34022C3.2741 1.09922 4.56828 0.333336 5.96994 0.333336H10.0301C11.4317 0.333336 12.7259 1.09922 13.4213 2.34022L15.4855 6.0242Z';

package/esm/tokens/button.js

@@ -10,9 +10,9 @@ export const variants = {
     borderColor: 'bgSecondary'
   },
   tertiary: {
-    color: 'fgInverse',
-    background: 'bgInverse',
-    borderColor: 'bgInverse'
+    color: 'fg',
+    background: 'bgTertiary',
+    borderColor: 'bgTertiary'
   },
   foregroundMuted: {
     color: 'fgMuted',
@@ -28,6 +28,11 @@ export const variants = {
     color: 'fgInverse',
     background: 'bgNegative',
     borderColor: 'bgNegative'
+  },
+  inverse: {
+    color: 'fgInverse',
+    background: 'bgInverse',
+    borderColor: 'bgInverse'
   }
 };
 export const transparentVariants = {
@@ -60,5 +65,10 @@ export const transparentVariants = {
     color: 'fgNegative',
     background: 'bg',
     borderColor: 'transparent'
+  },
+  inverse: {
+    color: 'fg',
+    background: 'bg',
+    borderColor: 'transparent'
   }
 };

package/esm/tokens/cell.js

@@ -4,7 +4,17 @@ export const mediaSize = 32;
 // Height of the inner cell without padding
 export const imageSize = 48;
 export const pictogramScaleMultiplier = 1;
+
+/**
+ * @deprecated This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ * */
 export const listHeight = 80;
+
+/**
+ * @deprecated This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ * */
 export const compactListHeight = 40;
 
 /** Spacing configs for Cells to be parsed in [web/mobile]/hooks/useCellSpacing */
@@ -22,6 +32,11 @@ export const defaultSpacingConfig = {
     marginX: 0
   }
 };
+
+/**
+ * @deprecated Used by deprecated Select component. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ */
 export const selectOptionHeight = 56;
 export const cellPriorities = ['start', 'middle', 'end'];
 export const cellHelperTextVariants = {

package/esm/tokens/dot.js

@@ -14,15 +14,29 @@ export const avatarDotSizeMap = {
   m: 'xs',
   s: 'xs'
 };
+
+/**
+ * The fixed height of the DotCount component.
+ * Width grows based on content length.
+ **/
 export const dotCountSize = 24;
 
-// This works for the purposes of TabNavigation, but it's not stable
-// TODO Update this with more stable values
+/**
+ * @deprecated Use local sizing logic instead. This export is temporarily supported for
+ * compatibility. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ */
 export const dotSizeTokens = {
   s: 28,
   m: 36,
-  l: 42
+  l: 48
 };
+
+/**
+ * @deprecated Use local sizing logic instead. This export is temporarily supported for
+ * compatibility. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ */
 export const getDotSize = count => {
   if (!count || count < 10) return dotSizeTokens.s;
   if (count >= 10 && count < 100) return dotSizeTokens.m;

package/esm/tokens/select.js

@@ -9,7 +9,7 @@ export const selectCellSpacingConfig = {
   },
   innerSpacing: {
     marginX: 0,
-    paddingX: 2
+    paddingX: 3
   }
 };
 

package/esm/tour/useTour.js

@@ -1,15 +1,35 @@
 import { useCallback, useMemo, useState } from 'react';
 
+// TODO: move all props irrelevant to useTour core logic to web and mobile packages. eg TourStepArrowComponent, TourStepComponent, TourScrollOptions, etc.
+
+/**
+ * Placement for the tour step arrow. Matches the placement values used by positioning libraries
+ * (e.g. @floating-ui) so web/mobile can pass through their placement directly.
+ */
+
+/**
+ * Arrow coordinates and offsets for the tour step arrow. Matches the shape provided by arrow
+ * middleware (e.g. @floating-ui) so web/mobile can pass through their arrow data directly.
+ */
+
 /**
  * @deprecated Import from `@coinbase/cds-web` or `@coinbase/cds-mobile` instead. This will be removed in a future major release.
  * @deprecationExpectedRemoval v10
  */
 
 /**
+ * The TourStepArrowComponent forwards a ref to the underlying element.
+ * This is required for the positioning library to work correctly.
  * @deprecated Import from `@coinbase/cds-web` or `@coinbase/cds-mobile` instead. This will be removed in a future major release.
  * @deprecationExpectedRemoval v10
  */
 
+/**
+ * API returned by useTour and provided via TourContext.
+ * @template TourStepId - Step id string literal type.
+ * @template TTarget - Type of the active step's target element (e.g. HTMLElement for web, View for react-native). Defaults to unknown.
+ */
+
 /**
  * A controlled hook for managing tour state, such as the currently active tour step.
  * @see {@link https://linear.app/coinbase/issue/CDS-1878 CDS-1878} for planned refactor to make this API platform agnostic.

package/esm/types/index.js

@@ -49,7 +49,6 @@ export * from './SharedProps';
 export * from './SpacingProps';
 export * from './SparklineInteractiveHeaderBaseProps';
 export * from './SpreadPropsSafely';
-export * from './StickyFooterProps';
 export * from './TagBaseProps';
 export * from './TextBaseProps';
 export * from './TooltipBaseProps';

package/esm/utils/flattenNodes.js

@@ -6,11 +6,6 @@
 
 import { Children, cloneElement, isValidElement } from 'react';
 import { isFragment } from 'react-is';
-// typeguard to check for props in a ReactChild
-export function hasProps(child) {
-  return child.props !== undefined;
-}
-
 // eslint-disable-next-line no-restricted-exports
 export default function flattenNodes(children) {
   let depth = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
@@ -18,7 +13,9 @@ export default function flattenNodes(children) {
   return Children.toArray(children).reduce((acc, node, nodeIndex) => {
     if (isFragment(node)) {
       var _node$key;
-      return [...acc, ...flattenNodes(node.props.children, depth + 1, keys.concat((_node$key = node.key) !== null && _node$key !== void 0 ? _node$key : nodeIndex))];
+      // react-is only narrows type down to ReactElement, not FragmentElement
+      const fragmentNode = node;
+      return [...acc, ...flattenNodes(fragmentNode.props.children, depth + 1, keys.concat((_node$key = node.key) !== null && _node$key !== void 0 ? _node$key : nodeIndex))];
     }
     if (/*#__PURE__*/isValidElement(node)) {
       return [...acc, /*#__PURE__*/cloneElement(node, {

package/esm/utils/getButtonSpacingProps.js

@@ -7,6 +7,10 @@ const buttonPaddingY = {
   default: 2,
   compact: 1
 };
+/**
+ * @deprecated This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ */
 export const getButtonSpacingProps = _ref => {
   let {
     compact,
@@ -14,6 +18,7 @@ export const getButtonSpacingProps = _ref => {
   } = _ref;
   if (flush) return {
     paddingX: buttonPaddingX.flush,
+    paddingY: compact ? buttonPaddingY.compact : buttonPaddingY.default,
     marginEnd: flush === 'end' ? -buttonPaddingX.flush : undefined,
     marginStart: flush === 'start' ? -buttonPaddingX.flush : undefined
   };

package/esm/utils/mergeRefs.js

@@ -0,0 +1,81 @@
+import { useCallback } from 'react';
+function getReactElementRef(element) {
+  // React 19: refs are on props
+  if (typeof element.props === 'object' && element.props !== null && 'ref' in element.props) {
+    var _ref;
+    return (_ref = element.props.ref) !== null && _ref !== void 0 ? _ref : null;
+  }
+
+  // React 18 and earlier: refs are on the element
+  if ('ref' in element) {
+    var _ref2;
+    return (_ref2 = element.ref) !== null && _ref2 !== void 0 ? _ref2 : null;
+  }
+  return null;
+}
+
+/**
+ * Merge multiple refs into a single ref callback.
+ *
+ * - Supports callback refs and object refs.
+ * - Ignores `null`/`undefined` refs.
+ * - Intentionally does not support legacy string refs.
+ */
+export const mergeRefs = function () {
+  for (var _len = arguments.length, refs = new Array(_len), _key = 0; _key < _len; _key++) {
+    refs[_key] = arguments[_key];
+  }
+  return value => {
+    refs.forEach(ref => {
+      if (typeof ref === 'function') {
+        ref(value);
+      } else if (ref != null) {
+        ref.current = value;
+      }
+    });
+  };
+};
+
+/**
+ * Like `mergeRefs`, but also includes an existing ref already present on a React element.
+ *
+ * This is React 18/19 compatible:
+ * - React 19 stores refs on `element.props.ref`
+ * - React 18 and earlier store refs on `element.ref`
+ */
+export const mergeReactElementRef = function (element) {
+  const existingRef = getReactElementRef(element);
+  for (var _len2 = arguments.length, refs = new Array(_len2 > 1 ? _len2 - 1 : 0), _key2 = 1; _key2 < _len2; _key2++) {
+    refs[_key2 - 1] = arguments[_key2];
+  }
+  return mergeRefs(...refs, existingRef);
+};
+
+/**
+ * @deprecated Prefer `mergeRefs` function instead. This will be removed in a future major release.
+ * @deprecationExpectedRemoval v10
+ */
+export const useMergeRefs = function () {
+  for (var _len3 = arguments.length, refs = new Array(_len3), _key3 = 0; _key3 < _len3; _key3++) {
+    refs[_key3] = arguments[_key3];
+  }
+  /**
+   * Merges multiple refs into a single ref callback. Supports both callback refs
+   * and object refs. `null`/`undefined` refs are ignored.
+   *
+   * The returned callback is referentially stable across renders as long as the
+   * underlying refs themselves are stable. This is critical under React 19,
+   * which schedules a detach (`oldRef(null)`) followed by an attach
+   * (`newRef(node)`) every time a ref-callback's identity changes. Without
+   * `useCallback` here, every render would create a new merged callback,
+   * triggering React 19's detach/attach lifecycle and — when one of the merged
+   * refs synchronously sets state during attach/detach — an infinite update
+   * loop ending in `Maximum update depth exceeded`.
+   */
+  return useCallback(value => {
+    mergeRefs(...refs)(value);
+  },
+  // The deps are the individual refs, not the rest-parameter array.
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  refs);
+};

package/esm/visualizations/useCounter.js

@@ -8,7 +8,7 @@ export const useCounter = _ref => {
   } = _ref;
   const skipAnimation = isStorybook();
   const [count, setCount] = useState(skipAnimation ? endNum : startNum);
-  const timeoutRef = useRef();
+  const timeoutRef = useRef(undefined);
   useEffect(() => {
     const clearTimeoutRef = () => {
       clearTimeout(timeoutRef.current);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinbase/cds-common",
-  "version": "8.66.2",
+  "version": "9.0.0-rc.1",
   "description": "Coinbase Design System - Common",
   "repository": {
     "type": "git",
@@ -34,13 +34,12 @@
     "CHANGELOG"
   ],
   "peerDependencies": {
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1"
+    "react": "^18.0.0 || ~19.1.2"
   },
   "dependencies": {
     "@coinbase/cds-icons": "^5.16.0",
     "@coinbase/cds-illustrations": "^4.38.0",
-    "@coinbase/cds-mcp-server": "^8.66.2",
+    "@coinbase/cds-mcp-server": "^9.0.0-rc.1",
     "@coinbase/cds-utils": "^2.3.5",
     "@modelcontextprotocol/sdk": "^1.13.1",
     "d3-array": "^3.2.4",
@@ -49,16 +48,18 @@
     "d3-scale": "^4.0.2",
     "d3-shape": "^3.2.0",
     "lodash": "^4.17.21",
-    "react-is": "^17.0.2",
+    "react-is": "19.1.2",
     "type-fest": "^2.19.0",
     "zod": "^3.23.8"
   },
   "devDependencies": {
     "@babel/core": "^7.28.0",
     "@babel/preset-env": "^7.28.0",
-    "@babel/preset-react": "^7.27.1",
+    "@babel/preset-react": "^7.28.5",
     "@babel/preset-typescript": "^7.27.1",
-    "@types/react": "^18.3.12",
-    "jest-date-mock": "^1.0.8"
+    "@types/react": "19.1.2",
+    "@types/react-is": "^19.0.0",
+    "jest-date-mock": "^1.0.8",
+    "react": "19.1.2"
   }
 }

package/dts/types/StickyFooterProps.d.ts

@@ -1,25 +0,0 @@
-import type { SharedAccessibilityProps } from './SharedAccessibilityProps';
-import type { SharedProps } from './SharedProps';
-import type { PaddingProps } from './SpacingProps';
-/**
- * @deprecated Use StickyFooterProps from @coinbase/cds-mobile instead. This will be removed in a future major release.
- * @deprecationExpectedRemoval v8
- */
-export type StickyFooterProps = {
-  /**
-   * React children to be rendered inside the StickyFooter.
-   */
-  children?: React.ReactNode;
-  /**
-   * Whether to apply a top border and shadow to the StickyFooter.
-   */
-  elevated?: boolean;
-  /**
-   * The WAI-ARIA role for the StickyFooter element.
-   * @see https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles
-   */
-  role?: React.AriaRole;
-} & SharedProps &
-  PaddingProps &
-  Pick<SharedAccessibilityProps, 'accessibilityLabel'>;
-//# sourceMappingURL=StickyFooterProps.d.ts.map

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

@@ -1 +0,0 @@
-{"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/types/StickyFooterProps.js

@@ -1 +0,0 @@
-export {};