@coinbase/cds-web 8.43.0 → 8.44.0

package/esm/alpha/__figma__/Select.figma.js

@@ -0,0 +1,68 @@
+const _excluded = ["type", "value"];
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+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); }
+function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
+function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
+import { figma } from '@figma/code-connect';
+import { Select } from '../select/Select';
+import { jsx as _jsx } from "react/jsx-runtime";
+const selectOptions = [{
+  value: 'apple',
+  label: 'Apple'
+}, {
+  value: 'banana',
+  label: 'Banana'
+}, {
+  value: 'orange',
+  label: 'Orange',
+  description: 'Citrus'
+}];
+figma.connect(Select, 'https://www.figma.com/design/k5CtyJccNQUGMI5bI4lJ2g/✨-CDS-Components?node-id=71762-14938', {
+  imports: ["import { Select } from '@coinbase/cds-web/alpha/select/Select'"],
+  props: {
+    type: figma.enum('type', {
+      'single select': 'single',
+      'multi-select': 'multi'
+    }),
+    disabled: figma.boolean('disabled'),
+    compact: figma.boolean('compact'),
+    label: figma.boolean('show label', {
+      true: figma.boolean('show info icon') ? "<HStack alignItems=\"center\">\n          <InputLabel>".concat(figma.string('label string'), "</InputLabel>\n          <Tooltip content=\"This will be visible to other users.\">\n            <Icon active color=\"fg\" name=\"info\" padding={0.75} size=\"xs\" tabIndex={0} />\n          </Tooltip>\n        </HStack>") : figma.string('label string'),
+      false: undefined
+    }),
+    start: figma.boolean('show start', {
+      true: figma.instance('start'),
+      false: undefined
+    }),
+    helperText: figma.boolean('show helper text', {
+      true: figma.string('helper text'),
+      false: undefined
+    }),
+    placeholder: figma.string('placeholderText'),
+    variant: figma.enum('state', {
+      default: undefined,
+      positive: 'positive',
+      negative: 'negative'
+    }),
+    value: figma.enum('type', {
+      'single select': 'Item 1',
+      'multi-select': ['Item 1', 'Item 2']
+    })
+  },
+  example: _ref => {
+    let {
+        type,
+        value
+      } = _ref,
+      props = _objectWithoutProperties(_ref, _excluded);
+    return /*#__PURE__*/_jsx(Select, _objectSpread(_objectSpread({}, props), {}, {
+      onChange: () => {},
+      options: selectOptions,
+      type: type,
+      value: value
+    }));
+  }
+});

package/esm/navigation/NavigationBar.js

@@ -1,75 +1,108 @@
+const _excluded = ["start", "children", "end", "bottom", "accessibilityLabel", "background", "paddingX", "paddingTop", "paddingBottom", "position", "top", "left", "right", "width", "dangerouslyDisableOverflowHidden", "columnGap", "rowGap", "className", "classNames", "style", "styles", "testID"];
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+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); }
+function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
+function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
 import React, { memo, useMemo } from 'react';
 import { usePreviousValue } from '@coinbase/cds-common/hooks/usePreviousValue';
 import { zIndex } from '@coinbase/cds-common/tokens/zIndex';
 import { Collapsible } from '../collapsible/Collapsible';
+import { cx } from '../cx';
 import { HStack, VStack } from '../layout';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-const COMPONENT_STATIC_CLASSNAME = 'cds-NavigationBar';
+export const navigationBarDefaultElement = 'nav';
+/**
+ * Static class names for NavigationBar component parts.
+ * Use these selectors to target specific elements with CSS.
+ */
+export const navigationBarClassNames = {
+  /** Root nav element containing the entire navigation bar */
+  root: 'cds-NavigationBar',
+  /** Container for the start slot (e.g., back button) */
+  start: 'cds-NavigationBar-start',
+  /** Container for the main children content (e.g., title) */
+  content: 'cds-NavigationBar-content'
+};
 export const NavigationBar = /*#__PURE__*/memo(_ref => {
   let {
-    start,
-    children,
-    end,
-    bottom,
-    accessibilityLabel = 'main navigation',
-    paddingX = 2,
-    paddingTop = 2,
-    paddingBottom = bottom ? undefined : 2,
-    dangerouslyDisableOverflowHidden,
-    columnGap,
-    rowGap = 1
-  } = _ref;
+      start,
+      children,
+      end,
+      bottom,
+      accessibilityLabel = 'main navigation',
+      background = 'bg',
+      paddingX = 2,
+      paddingTop = 2,
+      paddingBottom = bottom ? undefined : 2,
+      position = 'sticky',
+      top = 0,
+      left = 0,
+      right = 0,
+      width = '100%',
+      dangerouslyDisableOverflowHidden,
+      columnGap,
+      rowGap = 1,
+      className,
+      classNames,
+      style,
+      styles,
+      testID
+    } = _ref,
+    props = _objectWithoutProperties(_ref, _excluded);
   const prevStart = usePreviousValue(start);
   const startNode = useMemo(() => start || prevStart, [start, prevStart]);
-  return /*#__PURE__*/_jsxs(VStack, {
+  return /*#__PURE__*/_jsxs(VStack, _objectSpread(_objectSpread({
     borderedBottom: true,
     accessibilityLabel: accessibilityLabel,
     as: "nav",
-    background: "bg",
-    className: COMPONENT_STATIC_CLASSNAME,
+    background: background,
+    className: cx(navigationBarClassNames.root, className, classNames === null || classNames === void 0 ? void 0 : classNames.root),
     gap: rowGap,
-    left: 0,
+    left: left,
     paddingBottom: paddingBottom,
     paddingTop: paddingTop,
     paddingX: paddingX,
-    position: "sticky",
-    right: 0,
-    top: 0,
-    width: "100%",
-    zIndex: zIndex.navigation,
+    position: position,
+    right: right,
+    style: _objectSpread(_objectSpread({}, style), styles === null || styles === void 0 ? void 0 : styles.root),
+    testID: testID,
+    top: top,
+    width: width,
+    zIndex: zIndex.navigation
+  }, props), {}, {
     children: [/*#__PURE__*/_jsxs(HStack, {
       alignItems: "center",
       gap: columnGap !== null && columnGap !== void 0 ? columnGap : {
         base: 2,
         phone: 1
       },
-      justifyContent: "space-between",
       overflow: "auto",
-      children: [/*#__PURE__*/_jsxs(HStack, {
+      children: [/*#__PURE__*/_jsx(Collapsible, {
+        collapsed: !start,
+        dangerouslyDisableOverflowHidden: dangerouslyDisableOverflowHidden,
+        direction: "horizontal",
+        children: /*#__PURE__*/_jsx(HStack, {
+          alignItems: "center",
+          className: cx(navigationBarClassNames.start, classNames === null || classNames === void 0 ? void 0 : classNames.start),
+          paddingEnd: columnGap !== null && columnGap !== void 0 ? columnGap : {
+            base: 2,
+            phone: 1
+          },
+          style: styles === null || styles === void 0 ? void 0 : styles.start,
+          children: startNode
+        })
+      }), /*#__PURE__*/_jsx(HStack, {
         alignItems: "center",
+        className: cx(navigationBarClassNames.content, classNames === null || classNames === void 0 ? void 0 : classNames.content),
         flexGrow: 1,
-        flexShrink: 0,
-        justifyContent: "flex-start",
-        children: [/*#__PURE__*/_jsx(Collapsible, {
-          collapsed: !start,
-          dangerouslyDisableOverflowHidden: dangerouslyDisableOverflowHidden,
-          direction: "horizontal",
-          children: /*#__PURE__*/_jsx(HStack, {
-            alignItems: "center",
-            paddingEnd: columnGap !== null && columnGap !== void 0 ? columnGap : {
-              base: 2,
-              phone: 1
-            },
-            children: startNode
-          })
-        }), /*#__PURE__*/_jsx(HStack, {
-          alignItems: "center",
-          flexGrow: 1,
-          gap: 1,
-          children: children
-        })]
+        gap: 1,
+        style: styles === null || styles === void 0 ? void 0 : styles.content,
+        children: children
       }), end]
     }), bottom]
-  });
+  }));
 });
 NavigationBar.displayName = 'NavigationBar';

package/esm/overlays/FocusTrap.js

@@ -1,4 +1,5 @@
 import React, { memo, useCallback, useEffect, useMemo, useRef } from 'react';
+import { useMergeRefs } from '@coinbase/cds-common/hooks/useMergeRefs';
 import { FOCUSABLE_ELEMENTS } from '@coinbase/cds-common/tokens/overlays';
 import { debounce } from '@coinbase/cds-common/utils/debounce';
 import { getBrowserGlobals } from '../utils/browser';
@@ -203,12 +204,13 @@ export const FocusTrap = /*#__PURE__*/memo(function FocusTrap(_ref) {
 
   // only works for single child
   const onlyChild = React.Children.only(children);
+  const mergedRef = useMergeRefs(childrenRef, children === null || children === void 0 ? void 0 : children.ref);
   if (!onlyChild) {
     return /*#__PURE__*/_jsx(_Fragment, {
       children: children
     });
   }
   return /*#__PURE__*/React.cloneElement(children, {
-    ref: childrenRef
+    ref: mergedRef
   });
 });

package/esm/overlays/handlebar/HandleBar.css

@@ -0,0 +1,3 @@
+@layer cds{.containerBaseCss-c1oq904k{display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;-webkit-box-pack:center;-webkit-justify-content:center;-ms-flex-pack:center;justify-content:center;padding-top:var(--space-2);padding-bottom:var(--space-2);}
+.containerPressableCss-cya0rqx{width:100%;cursor:-webkit-grab;cursor:-moz-grab;cursor:grab;touch-action:none;}.containerPressableCss-cya0rqx:active{cursor:-webkit-grabbing;cursor:-moz-grabbing;cursor:grabbing;}
+.handleCss-h1mpswnh{width:32px;height:4px;border-radius:var(--borderRadius-1000);opacity:0.4;}}

package/esm/overlays/handlebar/HandleBar.js

@@ -0,0 +1,66 @@
+const _excluded = ["testID", "onClose", "accessibilityLabel", "accessibilityHint", "classNames", "styles", "className", "style"];
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+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); }
+function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
+function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
+import React, { memo, useMemo } from 'react';
+import { handleBarHeight } from '@coinbase/cds-common/tokens/drawer';
+import { cx } from '../../cx';
+import { Box } from '../../layout';
+import { Pressable } from '../../system/Pressable';
+
+// Fixed pixel values used intentionally — handle size should not scale with theme density.
+import { jsx as _jsx } from "react/jsx-runtime";
+const HANDLE_WIDTH = 32;
+const HANDLE_OPACITY = 0.4;
+const containerBaseCss = "containerBaseCss-c1oq904k";
+const containerPressableCss = "containerPressableCss-cya0rqx";
+const handleCss = "handleCss-h1mpswnh";
+
+/**
+ * A draggable handle indicator for overlay components like Tray.
+ * @note Web only supports inside handlebar.
+ */
+
+export const HandleBar = /*#__PURE__*/memo(_ref => {
+  var _classNames$root;
+  let {
+      testID = 'handleBar',
+      onClose,
+      accessibilityLabel,
+      accessibilityHint,
+      classNames,
+      styles,
+      className,
+      style
+    } = _ref,
+    props = _objectWithoutProperties(_ref, _excluded);
+  const rootStyle = useMemo(() => style || styles !== null && styles !== void 0 && styles.root ? _objectSpread(_objectSpread({}, style), styles === null || styles === void 0 ? void 0 : styles.root) : undefined, [style, styles === null || styles === void 0 ? void 0 : styles.root]);
+  const handleClassName = cx(handleCss, classNames === null || classNames === void 0 ? void 0 : classNames.handle);
+  return /*#__PURE__*/_jsx(Box, _objectSpread(_objectSpread({
+    className: cx(containerBaseCss, onClose && containerPressableCss, (_classNames$root = classNames === null || classNames === void 0 ? void 0 : classNames.root) !== null && _classNames$root !== void 0 ? _classNames$root : className),
+    "data-testid": testID,
+    style: rootStyle
+  }, props), {}, {
+    children: onClose ? /*#__PURE__*/_jsx(Pressable, {
+      noScaleOnPress: true,
+      accessibilityHint: accessibilityHint,
+      accessibilityLabel: accessibilityLabel,
+      background: "bgInverse",
+      borderColor: "transparent",
+      className: handleClassName,
+      onClick: onClose,
+      style: styles === null || styles === void 0 ? void 0 : styles.handle
+    }) : /*#__PURE__*/_jsx(Box, {
+      accessibilityHint: accessibilityHint,
+      accessibilityLabel: accessibilityLabel,
+      background: "bgInverse",
+      className: handleClassName,
+      style: styles === null || styles === void 0 ? void 0 : styles.handle
+    })
+  }));
+});
+import "./HandleBar.css";

package/esm/overlays/handlebar/index.js

@@ -0,0 +1 @@
+export * from './HandleBar';

package/esm/overlays/tray/Tray.css

@@ -0,0 +1,7 @@
+@layer cds{.trayHeaderBorderBaseCss-t552jyb{border-bottom-width:var(--borderWidth-100);border-bottom-style:solid;border-bottom-color:transparent;}
+.trayHeaderBorderVisibleCss-tx59ve0{border-bottom-color:var(--color-bgLine);}
+.trayContainerBaseCss-t1gubbn2{z-index:1;display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-flex-direction:column;-ms-flex-direction:column;flex-direction:column;overflow:hidden;-webkit-box-flex:1;-webkit-flex-grow:1;-ms-flex-positive:1;flex-grow:1;min-height:0;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;}
+.trayContainerPinBottomCss-ttp17ir{border-top-left-radius:var(--borderRadius-600);border-top-right-radius:var(--borderRadius-600);}
+.trayContainerPinTopCss-t1ql0a7m{border-bottom-left-radius:var(--borderRadius-600);border-bottom-right-radius:var(--borderRadius-600);}
+.trayContainerPinLeftCss-tddpnpb{border-top-right-radius:var(--borderRadius-600);border-bottom-right-radius:var(--borderRadius-600);}
+.trayContainerPinRightCss-t17d10kx{border-top-left-radius:var(--borderRadius-600);border-bottom-left-radius:var(--borderRadius-600);}}