@zohodesk/components 1.0.0-temp-260 → 1.0.0-temp-259.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/CHANGELOG.md +4 -0
  2. package/assets/Appearance/dark/mode/Component_v1_DarkMode.module.css +5 -20
  3. package/assets/Appearance/light/mode/Component_v1_LightMode.module.css +5 -20
  4. package/assets/Appearance/pureDark/mode/Component_v1_PureDarkMode.module.css +5 -20
  5. package/es/v1/Button/Button.js +160 -107
  6. package/es/v1/Button/README.md +106 -42
  7. package/es/v1/Button/__tests__/Button.spec.js +138 -47
  8. package/es/v1/Button/__tests__/__snapshots__/Button.spec.js.snap +1105 -332
  9. package/es/v1/Button/constants/index.js +26 -20
  10. package/es/v1/Button/constants/presets.js +149 -0
  11. package/es/v1/Button/css/Button_v1.module.css +33 -16
  12. package/es/v1/Button/css/cssJSLogic.js +56 -28
  13. package/es/v1/Button/props/defaultProps.js +2 -6
  14. package/es/v1/Button/props/propTypes.js +26 -8
  15. package/es/v1/helpers/colorHelpers/__tests__/colorHelper.spec.js +357 -0
  16. package/es/v1/helpers/colorHelpers/background/backgroundColor.module.css +40 -40
  17. package/es/v1/helpers/colorHelpers/border/borderColor.module.css +25 -25
  18. package/es/v1/helpers/colorHelpers/colorHelper.js +117 -139
  19. package/es/v1/helpers/colorHelpers/constants/index.js +45 -4
  20. package/es/v1/helpers/colorHelpers/index.js +0 -1
  21. package/es/v1/helpers/colorHelpers/text/textColor.module.css +35 -35
  22. package/lib/v1/Button/Button.js +179 -119
  23. package/lib/v1/Button/README.md +106 -42
  24. package/lib/v1/Button/__tests__/Button.spec.js +194 -87
  25. package/lib/v1/Button/__tests__/__snapshots__/Button.spec.js.snap +1105 -332
  26. package/lib/v1/Button/constants/index.js +31 -28
  27. package/lib/v1/Button/constants/presets.js +167 -0
  28. package/lib/v1/Button/css/Button_v1.module.css +33 -16
  29. package/lib/v1/Button/css/cssJSLogic.js +42 -19
  30. package/lib/v1/Button/props/defaultProps.js +1 -5
  31. package/lib/v1/Button/props/propTypes.js +41 -7
  32. package/lib/v1/helpers/colorHelpers/__tests__/colorHelper.spec.js +363 -0
  33. package/lib/v1/helpers/colorHelpers/background/backgroundColor.module.css +40 -40
  34. package/lib/v1/helpers/colorHelpers/border/borderColor.module.css +25 -25
  35. package/lib/v1/helpers/colorHelpers/colorHelper.js +127 -153
  36. package/lib/v1/helpers/colorHelpers/constants/index.js +45 -4
  37. package/lib/v1/helpers/colorHelpers/index.js +2 -24
  38. package/lib/v1/helpers/colorHelpers/text/textColor.module.css +35 -35
  39. package/package.json +4 -4
  40. package/es/AdvancedPopup/AdvancedPopup.js +0 -105
  41. package/lib/AdvancedPopup/AdvancedPopup.js +0 -122
@@ -5,7 +5,7 @@ function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" =
5
5
  Object.defineProperty(exports, "__esModule", {
6
6
  value: true
7
7
  });
8
- exports["default"] = void 0;
8
+ exports["default"] = exports.ButtonPresentational = void 0;
9
9
 
10
10
  var _cssUtility = require("@dot-system/css-utility");
11
11
 
@@ -17,24 +17,24 @@ var _Icon = _interopRequireDefault(require("@zohodesk/icons/es/Icon"));
17
17
 
18
18
  var _Flex = _interopRequireDefault(require("@zohodesk/layout/es/Flex/Flex"));
19
19
 
20
- var _Typography = _interopRequireDefault(require("../../Typography/Typography"));
21
-
22
20
  var _renderNode = _interopRequireWildcard(require("@zohodesk/utils/es/renderNode"));
23
21
 
24
- var _propTypes = _interopRequireDefault(require("./props/propTypes"));
25
-
26
- var _defaultProps = _interopRequireDefault(require("./props/defaultProps"));
27
-
28
22
  var _constants = require("@zohodesk/dotkit/es/utils/constants");
29
23
 
30
24
  var _constants2 = require("./constants");
31
25
 
26
+ var _Typography = _interopRequireDefault(require("../../Typography/Typography"));
27
+
32
28
  var _Spinner = _interopRequireDefault(require("../shared/Spinner/Spinner"));
33
29
 
34
30
  var _SuccessTick = _interopRequireDefault(require("../shared/SuccessTick/SuccessTick"));
35
31
 
36
32
  var _cssJSLogic = _interopRequireDefault(require("./css/cssJSLogic"));
37
33
 
34
+ var _propTypes = _interopRequireDefault(require("./props/propTypes"));
35
+
36
+ var _defaultProps = _interopRequireDefault(require("./props/defaultProps"));
37
+
38
38
  function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
39
39
 
40
40
  function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
@@ -53,17 +53,18 @@ var getTypographySize = function getTypographySize(size) {
53
53
  return _constants2.TYPOGRAPHY_SIZE_MAP[size] || '13';
54
54
  };
55
55
 
56
- var Button = /*#__PURE__*/(0, _react.forwardRef)(function Button(props, ref) {
57
- var palette = props.palette,
58
- bgAppearance = props.bgAppearance,
59
- borderAppearance = props.borderAppearance,
56
+ var ButtonPresentational = /*#__PURE__*/(0, _react.forwardRef)(function ButtonPresentational(props, ref) {
57
+ var isLoading = props.isLoading,
58
+ isSuccess = props.isSuccess,
59
+ isDisabled = props.isDisabled,
60
+ isDisabledState = props.isDisabledState,
61
+ overlayActive = props.overlayActive,
60
62
  variant = props.variant,
61
- status = props.status,
63
+ iconPlacement = props.iconPlacement,
62
64
  loaderPlacement = props.loaderPlacement,
63
65
  size = props.size,
64
66
  iconName = props.iconName,
65
67
  iconSize = props.iconSize,
66
- iconPlacement = props.iconPlacement,
67
68
  renderIcon = props.renderIcon,
68
69
  renderBefore = props.renderBefore,
69
70
  renderAfter = props.renderAfter,
@@ -71,105 +72,94 @@ var Button = /*#__PURE__*/(0, _react.forwardRef)(function Button(props, ref) {
71
72
  renderSuccess = props.renderSuccess,
72
73
  children = props.children,
73
74
  type = props.type,
74
- onClick = props.onClick,
75
- isDisabled = props.isDisabled,
76
- isReadOnly = props.isReadOnly,
77
75
  isSelected = props.isSelected,
78
- shape = props.shape,
79
- paletteShade = props.paletteShade,
80
- disabledAppearance = props.disabledAppearance,
81
76
  title = props.title,
82
77
  customProps = props.customProps,
83
78
  customAttributes = props.customAttributes,
84
79
  a11yAttributes = props.a11yAttributes,
85
80
  customId = props.customId,
86
- testId = props.testId;
87
- var isLoading = status === _constants2.STATUS.LOADING;
88
- var isSuccess = status === _constants2.STATUS.SUCCESS;
89
- var isDisabledState = isDisabled || isLoading;
90
- var isInteractionDisabled = isDisabledState || isReadOnly;
91
- var overlayActive = (isLoading || isSuccess) && loaderPlacement === _constants2.LOADER_PLACEMENT.OVERLAY;
92
- var _customProps$text = customProps.text,
93
- contentProps = _customProps$text === void 0 ? _constants.DUMMY_OBJECT : _customProps$text,
94
- _customProps$icon = customProps.icon,
95
- iconProps = _customProps$icon === void 0 ? _constants.DUMMY_OBJECT : _customProps$icon;
96
- var iconTagAttributes = (0, _react.useMemo)(function () {
97
- return _objectSpread(_objectSpread({}, iconProps.tagAttributes || _constants.DUMMY_OBJECT), {}, {
98
- 'data-test-id': testId ? "".concat(testId, "_icon") : undefined
99
- });
100
- }, [iconProps.tagAttributes, testId]);
101
- var classes = (0, _react.useMemo)(function () {
102
- return (0, _cssJSLogic["default"])({
103
- props: props
104
- });
105
- }, [palette, bgAppearance, borderAppearance, paletteShade, size, variant, status, isDisabled, isReadOnly, isSelected, shape, loaderPlacement, disabledAppearance, props.customClass]);
106
- var loaderOverlayClass = classes.loaderOverlayClass,
107
- successOverlayClass = classes.successOverlayClass,
108
- contentWrapperClass = classes.contentWrapperClass,
109
- textClassName = classes.textClassName,
110
- buttonClassName = classes.buttonClassName,
111
- iconClassName = classes.iconClassName;
112
- var showIcon = variant !== _constants2.VARIANT.TEXT && (renderIcon || iconName);
113
-
114
- var _handleClick = function _handleClick(event) {
115
- if (isInteractionDisabled) {
116
- return;
117
- }
81
+ testId = props.testId,
82
+ dataSelectorId = props.dataSelectorId,
83
+ handleClick = props.handleClick,
84
+ classNames = props.classNames;
85
+ var loaderOverlayClass = classNames.loaderOverlayClass,
86
+ successOverlayClass = classNames.successOverlayClass,
87
+ contentWrapperClass = classNames.contentWrapperClass,
88
+ textClassName = classNames.textClassName,
89
+ buttonClassName = classNames.buttonClassName,
90
+ iconClassName = classNames.iconClassName,
91
+ loaderClassName = classNames.loaderClassName,
92
+ successClassName = classNames.successClassName;
93
+
94
+ var _ref = customProps || _constants.DUMMY_OBJECT,
95
+ _ref$text = _ref.text,
96
+ contentProps = _ref$text === void 0 ? _constants.DUMMY_OBJECT : _ref$text,
97
+ _ref$icon = _ref.icon,
98
+ iconProps = _ref$icon === void 0 ? _constants.DUMMY_OBJECT : _ref$icon;
99
+
100
+ var _ref2 = customAttributes || _constants.DUMMY_OBJECT,
101
+ _ref2$button = _ref2.button,
102
+ buttonAttributes = _ref2$button === void 0 ? _constants.DUMMY_OBJECT : _ref2$button,
103
+ _ref2$contentWrapper = _ref2.contentWrapper,
104
+ contentWrapperAttributes = _ref2$contentWrapper === void 0 ? _constants.DUMMY_OBJECT : _ref2$contentWrapper,
105
+ _ref2$loader = _ref2.loader,
106
+ loaderAttributes = _ref2$loader === void 0 ? _constants.DUMMY_OBJECT : _ref2$loader,
107
+ _ref2$success = _ref2.success,
108
+ successAttributes = _ref2$success === void 0 ? _constants.DUMMY_OBJECT : _ref2$success,
109
+ _ref2$icon = _ref2.icon,
110
+ iconAttributes = _ref2$icon === void 0 ? _constants.DUMMY_OBJECT : _ref2$icon,
111
+ _ref2$text = _ref2.text,
112
+ textAttributes = _ref2$text === void 0 ? _constants.DUMMY_OBJECT : _ref2$text;
113
+
114
+ var iconTagAttributes = _objectSpread(_objectSpread({}, iconAttributes), {}, {
115
+ 'data-test-id': testId ? "".concat(testId, "_icon") : undefined
116
+ });
118
117
 
119
- onClick(event);
120
- };
118
+ var showIcon = variant !== _constants2.VARIANT.TEXT && (renderIcon || iconName);
121
119
 
122
120
  var _renderLoader = function _renderLoader() {
123
- if (!isLoading) {
124
- return null;
125
- }
126
-
127
- if ((0, _renderNode.isRenderable)(renderLoader)) {
128
- return (0, _renderNode["default"])(renderLoader, {
129
- status: status
130
- });
131
- }
132
-
133
- var loaderClassName = loaderPlacement === _constants2.LOADER_PLACEMENT.OVERLAY ? loaderOverlayClass : '';
134
- return /*#__PURE__*/_react["default"].createElement(_Flex["default"], {
121
+ if (!isLoading) return null;
122
+ var isOverlay = loaderPlacement === _constants2.LOADER_PLACEMENT.OVERLAY;
123
+ var hasCustomLoader = (0, _renderNode.isRenderable)(renderLoader);
124
+ if (hasCustomLoader && !isOverlay) return (0, _renderNode["default"])(renderLoader, {
125
+ status: _constants2.STATUS.LOADING
126
+ });
127
+ return /*#__PURE__*/_react["default"].createElement(_Flex["default"], _extends({
135
128
  $ui_displayMode: "flex",
136
129
  $ui_alignItems: "center",
137
130
  $ui_justifyContent: "center",
138
- $ui_className: loaderClassName,
131
+ $ui_className: isOverlay ? loaderOverlayClass : '',
139
132
  testId: testId ? "".concat(testId, "_loader") : undefined
140
- }, /*#__PURE__*/_react["default"].createElement(_Spinner["default"], null));
133
+ }, hasCustomLoader ? undefined : loaderAttributes), hasCustomLoader ? (0, _renderNode["default"])(renderLoader, {
134
+ status: _constants2.STATUS.LOADING
135
+ }) : /*#__PURE__*/_react["default"].createElement(_Spinner["default"], {
136
+ customClass: loaderClassName
137
+ }));
141
138
  };
142
139
 
143
140
  var _renderSuccess = function _renderSuccess() {
144
- if (!isSuccess) {
145
- return null;
146
- }
147
-
148
- if ((0, _renderNode.isRenderable)(renderSuccess)) {
149
- return (0, _renderNode["default"])(renderSuccess, {
150
- status: status
151
- });
152
- }
153
-
154
- var successClassName = loaderPlacement === _constants2.LOADER_PLACEMENT.OVERLAY ? successOverlayClass : '';
155
- return /*#__PURE__*/_react["default"].createElement(_Flex["default"], {
141
+ if (!isSuccess) return null;
142
+ var isOverlay = loaderPlacement === _constants2.LOADER_PLACEMENT.OVERLAY;
143
+ var hasCustomSuccess = (0, _renderNode.isRenderable)(renderSuccess);
144
+ if (hasCustomSuccess && !isOverlay) return (0, _renderNode["default"])(renderSuccess, {
145
+ status: _constants2.STATUS.SUCCESS
146
+ });
147
+ return /*#__PURE__*/_react["default"].createElement(_Flex["default"], _extends({
156
148
  $ui_displayMode: "flex",
157
149
  $ui_alignItems: "center",
158
150
  $ui_justifyContent: "center",
159
- $ui_className: successClassName,
151
+ $ui_className: isOverlay ? successOverlayClass : '',
160
152
  testId: testId ? "".concat(testId, "_success") : undefined
161
- }, /*#__PURE__*/_react["default"].createElement(_SuccessTick["default"], null));
153
+ }, hasCustomSuccess ? undefined : successAttributes), hasCustomSuccess ? (0, _renderNode["default"])(renderSuccess, {
154
+ status: _constants2.STATUS.SUCCESS
155
+ }) : /*#__PURE__*/_react["default"].createElement(_SuccessTick["default"], {
156
+ customClass: successClassName
157
+ }));
162
158
  };
163
159
 
164
160
  var _renderIconNode = function _renderIconNode() {
165
- if (!showIcon) {
166
- return null;
167
- }
168
-
169
- if ((0, _renderNode.isRenderable)(renderIcon)) {
170
- return (0, _renderNode["default"])(renderIcon);
171
- }
172
-
161
+ if (!showIcon) return null;
162
+ if ((0, _renderNode.isRenderable)(renderIcon)) return (0, _renderNode["default"])(renderIcon);
173
163
  return /*#__PURE__*/_react["default"].createElement(_Icon["default"], _extends({}, iconProps, {
174
164
  iconClass: iconClassName,
175
165
  name: iconName,
@@ -179,59 +169,129 @@ var Button = /*#__PURE__*/(0, _react.forwardRef)(function Button(props, ref) {
179
169
  }));
180
170
  };
181
171
 
182
- var _renderBeforeNode = function _renderBeforeNode() {
183
- if (!(0, _renderNode.isRenderable)(renderBefore)) {
184
- return null;
185
- }
186
-
187
- return (0, _renderNode["default"])(renderBefore, props);
188
- };
189
-
190
- var _renderAfterNode = function _renderAfterNode() {
191
- if (!(0, _renderNode.isRenderable)(renderAfter)) {
192
- return null;
193
- }
194
-
195
- return (0, _renderNode["default"])(renderAfter, props);
196
- };
197
-
198
172
  var _renderContent = function _renderContent() {
199
- var shouldShowText = variant !== _constants2.VARIANT.ICON && children !== undefined && children !== null;
173
+ var shouldShowText = variant !== _constants2.VARIANT.ICON && children != null && (typeof children !== 'string' || children.trim() !== '');
200
174
  var showLoaderStart = isLoading && loaderPlacement === _constants2.LOADER_PLACEMENT.START;
201
175
  var showLoaderAfter = isLoading && loaderPlacement === _constants2.LOADER_PLACEMENT.END;
202
176
  var showSuccessStart = isSuccess && loaderPlacement === _constants2.LOADER_PLACEMENT.START;
203
177
  var showSuccessAfter = isSuccess && loaderPlacement === _constants2.LOADER_PLACEMENT.END;
204
- return /*#__PURE__*/_react["default"].createElement(_Flex["default"], {
178
+ return /*#__PURE__*/_react["default"].createElement(_Flex["default"], _extends({
205
179
  $ui_displayMode: "flex",
206
180
  $ui_direction: "row",
207
181
  $flag_shrink: true,
208
182
  $ui_alignItems: "center",
209
183
  $ui_justifyContent: "center",
210
184
  $ui_className: contentWrapperClass
211
- }, showLoaderStart ? _renderLoader() : null, showSuccessStart ? _renderSuccess() : null, _renderBeforeNode(), iconPlacement === _constants2.ICON_PLACEMENT.LEFT ? _renderIconNode() : null, shouldShowText ? /*#__PURE__*/_react["default"].createElement(_Typography["default"], _extends({}, contentProps, {
185
+ }, contentWrapperAttributes), showLoaderStart ? _renderLoader() : null, showSuccessStart ? _renderSuccess() : null, (0, _renderNode.isRenderable)(renderBefore) ? (0, _renderNode["default"])(renderBefore, props) : null, iconPlacement === _constants2.ICON_PLACEMENT.LEFT ? _renderIconNode() : null, shouldShowText ? typeof children === 'string' ? /*#__PURE__*/_react["default"].createElement(_Typography["default"], _extends({
186
+ $ui_size: getTypographySize(size)
187
+ }, contentProps, {
188
+ tagAttributes: textAttributes,
212
189
  $ui_className: textClassName,
213
- $ui_size: getTypographySize(size),
214
190
  $flag_dotted: variant !== _constants2.VARIANT.ICON
215
- }), children) : null, iconPlacement === _constants2.ICON_PLACEMENT.RIGHT ? _renderIconNode() : null, _renderAfterNode(), showLoaderAfter ? _renderLoader() : null, showSuccessAfter ? _renderSuccess() : null);
191
+ }), children) : children : null, iconPlacement === _constants2.ICON_PLACEMENT.RIGHT ? _renderIconNode() : null, (0, _renderNode.isRenderable)(renderAfter) ? (0, _renderNode["default"])(renderAfter, props) : null, showLoaderAfter ? _renderLoader() : null, showSuccessAfter ? _renderSuccess() : null);
216
192
  };
217
193
 
218
- var containerAttributes = _objectSpread(_objectSpread({}, customAttributes), {}, {
219
- 'data-id': customId,
220
- 'data-test-id': testId,
194
+ var containerAttributes = _objectSpread(_objectSpread({}, buttonAttributes), {}, {
195
+ 'data-id': isDisabled ? "".concat(customId, "_disabled") : customId,
196
+ 'data-test-id': isDisabled ? "".concat(testId, "_disabled") : testId,
197
+ 'data-selector-id': dataSelectorId,
221
198
  'data-title': title
222
199
  });
223
200
 
224
- return /*#__PURE__*/_react["default"].createElement("button", _extends({}, containerAttributes, a11yAttributes, {
201
+ return /*#__PURE__*/_react["default"].createElement("button", _extends({}, containerAttributes, {
202
+ "aria-busy": isLoading,
203
+ disabled: isDisabledState,
204
+ "aria-pressed": isSelected
205
+ }, a11yAttributes, {
225
206
  ref: ref,
226
207
  type: type,
227
208
  className: (0, _cssUtility.cn)(buttonClassName),
228
- "aria-busy": isLoading,
229
- "aria-disabled": isDisabledState,
230
- "aria-readonly": isReadOnly,
231
- "aria-pressed": isSelected,
232
- onClick: _handleClick
209
+ onClick: handleClick
233
210
  }), _renderContent(), overlayActive ? isLoading ? _renderLoader() : _renderSuccess() : null);
234
211
  });
212
+ exports.ButtonPresentational = ButtonPresentational;
213
+ ButtonPresentational.displayName = 'ButtonPresentational';
214
+ var Button = /*#__PURE__*/(0, _react.forwardRef)(function Button(props, ref) {
215
+ var palette = props.palette,
216
+ appearance = props.appearance,
217
+ hoverAppearance = props.hoverAppearance,
218
+ selectedAppearance = props.selectedAppearance,
219
+ variant = props.variant,
220
+ status = props.status,
221
+ loaderPlacement = props.loaderPlacement,
222
+ size = props.size,
223
+ iconName = props.iconName,
224
+ iconSize = props.iconSize,
225
+ iconPlacement = props.iconPlacement,
226
+ renderIcon = props.renderIcon,
227
+ renderBefore = props.renderBefore,
228
+ renderAfter = props.renderAfter,
229
+ renderLoader = props.renderLoader,
230
+ renderSuccess = props.renderSuccess,
231
+ children = props.children,
232
+ type = props.type,
233
+ onClick = props.onClick,
234
+ isDisabled = props.isDisabled,
235
+ isSelected = props.isSelected,
236
+ shape = props.shape,
237
+ disabledAppearance = props.disabledAppearance,
238
+ title = props.title,
239
+ customProps = props.customProps,
240
+ customAttributes = props.customAttributes,
241
+ a11yAttributes = props.a11yAttributes,
242
+ customId = props.customId,
243
+ testId = props.testId,
244
+ dataSelectorId = props.dataSelectorId,
245
+ customClass = props.customClass;
246
+ var isLoading = status === _constants2.STATUS.LOADING;
247
+ var isSuccess = status === _constants2.STATUS.SUCCESS;
248
+ var isDisabledState = isDisabled || isLoading;
249
+ var overlayActive = (isLoading || isSuccess) && loaderPlacement === _constants2.LOADER_PLACEMENT.OVERLAY;
250
+ var classNames = (0, _react.useMemo)(function () {
251
+ return (0, _cssJSLogic["default"])({
252
+ props: props
253
+ });
254
+ }, [palette, appearance, hoverAppearance, selectedAppearance, size, variant, status, isDisabled, isSelected, shape, loaderPlacement, disabledAppearance, customClass]);
255
+
256
+ var handleClick = function handleClick(event) {
257
+ if (isDisabledState) return;
258
+ onClick(event);
259
+ };
260
+
261
+ var essentials = {
262
+ isLoading: isLoading,
263
+ isSuccess: isSuccess,
264
+ isDisabled: isDisabled,
265
+ isDisabledState: isDisabledState,
266
+ overlayActive: overlayActive,
267
+ variant: variant,
268
+ iconPlacement: iconPlacement,
269
+ loaderPlacement: loaderPlacement,
270
+ size: size,
271
+ iconName: iconName,
272
+ iconSize: iconSize,
273
+ renderIcon: renderIcon,
274
+ renderBefore: renderBefore,
275
+ renderAfter: renderAfter,
276
+ renderLoader: renderLoader,
277
+ renderSuccess: renderSuccess,
278
+ children: children,
279
+ type: type,
280
+ isSelected: isSelected,
281
+ title: title,
282
+ customProps: customProps,
283
+ customAttributes: customAttributes,
284
+ a11yAttributes: a11yAttributes,
285
+ customId: customId,
286
+ testId: testId,
287
+ dataSelectorId: dataSelectorId,
288
+ handleClick: handleClick
289
+ };
290
+ return /*#__PURE__*/_react["default"].createElement(ButtonPresentational, _extends({}, essentials, {
291
+ classNames: classNames,
292
+ ref: ref
293
+ }));
294
+ });
235
295
  Button.propTypes = _propTypes["default"];
236
296
  Button.defaultProps = _defaultProps["default"];
237
297
  Button.displayName = 'Button';
@@ -18,14 +18,49 @@ import Button from '@zohodesk/components/es/v1/Button/Button';
18
18
  </Button>
19
19
  ```
20
20
 
21
- ### With Palette Variants
21
+ ### With Palette
22
22
 
23
23
  ```jsx
24
- <Button palette="primary">Save</Button>
24
+ <Button palette="brand">Save</Button>
25
25
  <Button palette="danger">Delete</Button>
26
26
  <Button palette="success">Confirm</Button>
27
27
  ```
28
28
 
29
+ ### With Appearance
30
+
31
+ `appearance`, `hoverAppearance`, and `selectedAppearance` are objects with optional `bg`, `border`, and `text` keys. Each key accepts `true` (use palette color), `false` (suppress), or a palette name string.
32
+
33
+ ```jsx
34
+ <Button palette="brand" appearance={{ bg: false, border: true }}>
35
+ Ghost
36
+ </Button>
37
+
38
+ <Button
39
+ palette="brand"
40
+ appearance={{ bg: false, border: true }}
41
+ hoverAppearance={{ bg: false, border: true }}
42
+ selectedAppearance={{ bg: false, border: true }}
43
+ >
44
+ Ghost with states
45
+ </Button>
46
+ ```
47
+
48
+ ### Using Presets
49
+
50
+ ```jsx
51
+ import {
52
+ BRAND_GHOST,
53
+ BRAND_TEXT_ONLY,
54
+ SECONDARY_GHOST_BRAND_TINTED_ONSELECT,
55
+ BRAND_TINTED_OUTLINE,
56
+ BRAND_TEXT_TINTED_HOVER
57
+ } from '@zohodesk/components/es/v1/Button/constants/presets';
58
+
59
+ <Button {...BRAND_GHOST}>Brand Ghost</Button>
60
+ <Button {...BRAND_TEXT_ONLY}>Brand Text Only</Button>
61
+ <Button {...SECONDARY_GHOST_BRAND_TINTED_ONSELECT}>Secondary Ghost</Button>
62
+ ```
63
+
29
64
  ### With Icon
30
65
 
31
66
  ```jsx
@@ -36,75 +71,104 @@ import Button from '@zohodesk/components/es/v1/Button/Button';
36
71
  </Button>
37
72
  ```
38
73
 
39
- ### Loading State
74
+ ### Loading / Success State
40
75
 
41
76
  ```jsx
42
- <Button status="loading" loaderPlacement="overlay">
43
- Saving...
44
- </Button>
45
-
46
- <Button status="loading" loaderPlacement="start">
47
- Loading
48
- </Button>
77
+ <Button status="loading" loaderPlacement="overlay">Saving...</Button>
78
+ <Button status="loading" loaderPlacement="start">Loading</Button>
79
+ <Button status="success">Done</Button>
49
80
  ```
50
81
 
51
- ### Disabled / Read Only
82
+ ### Disabled
52
83
 
53
84
  ```jsx
54
85
  <Button isDisabled>Disabled</Button>
55
- <Button isReadOnly>Read Only</Button>
86
+ <Button isDisabled disabledAppearance="strike">Disabled Strike</Button>
87
+ ```
88
+
89
+ ### Shape
90
+
91
+ ```jsx
92
+ <Button shape="pill">Pill</Button>
93
+ <Button shape="rectangle">Rectangle</Button>
94
+ <Button shape="roundedRectangle">Rounded</Button>
56
95
  ```
57
96
 
58
97
  ## Props
59
98
 
60
99
  | Prop | Type | Default | Description |
61
100
  |---|---|---|---|
62
- | `customId` | `string` | — | `data-id` attribute for automation |
63
- | `testId` | `string` | — | `data-test-id` attribute for testing |
64
- | `palette` | `oneOf: default, primary, secondary, danger, success` | `default` | Color palette |
65
- | `bgAppearance` | `oneOf: filled, onHover, none` | `filled` | Background behavior |
66
- | `borderAppearance` | `oneOf: default, onHover, none` | `default` | Border behavior |
101
+ | `palette` | `oneOf: brand, brandLighter, info, infoLighter, secondary, secondaryLighter, danger, dangerLighter, success, successLighter, warning, warningLighter` | `''` | Color palette |
102
+ | `appearance` | `{ bg?, border?, text? }` | `{ bg: true, text: true }` | Color treatments at rest. Values: `true`, `false`, or a palette name |
103
+ | `hoverAppearance` | `{ bg?, border?, text? }` | `{ bg: true, text: true }` | Color treatments on hover/focus/active |
104
+ | `selectedAppearance` | `{ bg?, border?, text? }` | `{ bg: true, text: true }` | Color treatments when `isSelected` is true |
67
105
  | `variant` | `oneOf: text, icon, iconWithText` | `text` | Display variant |
68
106
  | `size` | `oneOf: small, medium, large, full` | `medium` | Size variant |
69
107
  | `status` | `oneOf: default, loading, success` | `default` | Status state |
70
- | `loaderPlacement` | `oneOf: start, end, overlay` | `overlay` | Where loader appears |
108
+ | `loaderPlacement` | `oneOf: start, end, overlay` | `overlay` | Where the loader appears |
109
+ | `shape` | `oneOf: pill, rectangle, roundedRectangle` | `roundedRectangle` | Border shape |
71
110
  | `iconName` | `string` | — | Icon name from `@zohodesk/icons` |
72
111
  | `iconSize` | `number` | `16` | Icon size in pixels |
73
112
  | `iconPlacement` | `oneOf: left, right` | `left` | Icon position relative to text |
74
- | `paletteShade` | `oneOf: default, lighter` | `default` | Shade variant |
75
- | `disabledAppearance` | `oneOf: none, dull, strike` | `dull` | Disabled visual style |
113
+ | `disabledAppearance` | `oneOf: none, dull, strike` | `dull` | Visual style when disabled |
114
+ | `isDisabled` | `bool` | `false` | Disables the button |
115
+ | `isSelected` | `bool` | `false` | Selected/pressed state (`aria-pressed`) |
116
+ | `type` | `oneOf: button, submit, reset` | `button` | HTML button type |
117
+ | `onClick` | `func` | — | Click handler (suppressed when disabled or loading) |
118
+ | `title` | `string` | — | Tooltip / `data-title` attribute |
119
+ | `children` | `node` | — | Button label content |
76
120
  | `renderIcon` | `node \| func` | — | Custom icon render slot |
77
121
  | `renderBefore` | `node \| func` | — | Slot before main content |
78
122
  | `renderAfter` | `node \| func` | — | Slot after main content |
79
123
  | `renderLoader` | `node \| func` | — | Custom loader render slot |
80
124
  | `renderSuccess` | `node \| func` | — | Custom success render slot |
81
- | `children` | `node` | — | Button text content |
82
- | `type` | `oneOf: button, submit, reset` | `button` | HTML button type |
83
- | `onClick` | `func` | — | Click event handler |
84
- | `isDisabled` | `bool` | `false` | Disables the button |
85
- | `isReadOnly` | `bool` | `false` | Read-only state |
86
- | `isSelected` | `bool` | `false` | Selected/pressed state |
87
- | `isRounded` | `bool` | `false` | Rounded border radius |
88
- | `title` | `string` | — | Title/tooltip text |
125
+ | `customId` | `string` | — | `data-id` attribute |
126
+ | `testId` | `string` | — | `data-test-id` attribute |
127
+ | `dataSelectorId` | `string` | — | `data-selector-id` attribute |
128
+ | `a11yAttributes` | `object` | `{}` | Extra ARIA/accessibility attributes spread onto `<button>` |
129
+ | `customClass` | `{ wrapper?, text?, icon?, loader?, success? }` | `{}` | CSS class overrides per part |
130
+ | `customProps` | `{ text?, icon? }` | `{}` | Extra props forwarded to text/icon sub-elements |
131
+ | `customAttributes` | `{ button?, contentWrapper?, loader?, success?, icon?, text? }` | `{}` | Extra HTML attributes per internal element |
132
+
133
+ ## Presets
134
+
135
+ Ready-made palette + appearance combinations exported from `constants/presets`:
136
+
137
+ | Name | Palette | Appearance | Description |
138
+ |---|---|---|---|
139
+ | `BRAND_GHOST` | `brand` | `{ bg: false, border: true }` | Transparent bg, brand border |
140
+ | `BRAND_TEXT_ONLY` | `brand` | `{ bg: false }` | Text only, no border |
141
+ | `BRAND_TINTED_OUTLINE` | `brandLighter` | `{ border: true }` | Tinted fill, brand border |
142
+ | `SUCCESS_GHOST` | `success` | `{ bg: false, border: true }` | Transparent bg, success border |
143
+ | `SUCCESS_TEXT_ONLY` | `success` | `{ bg: false }` | Text only, no border |
144
+ | `SUCCESS_TINTED_OUTLINE` | `successLighter` | `{ border: true }` | Tinted fill, success border |
145
+ | `SECONDARY_GHOST_BRAND_TINTED_ONSELECT` | `secondary` | `{ bg: false, border: true }` | Secondary ghost; selected state switches to brand tint |
146
+ | `BLACK_TEXT_BRAND_ONHOVER` | `brand` | `{ bg: false, text: 'black' }` | Black text, brand color on hover |
147
+ | `BRAND_BG_ONSELECT` | `brand` | `{ bg: false, border: true }` | Ghost without a defined selected state |
148
+ | `BRAND_TEXT_TINTED_HOVER` | `brandLighter` | `{ bg: false }` | Ghost that becomes tinted on hover |
149
+ | `BRAND_TEXT_TINTED_DANGER_HOVER` | `brandLighter` | `{ bg: false }` | Ghost that becomes danger-tinted on hover |
89
150
 
90
151
  ## Customization
91
152
 
92
153
  ### Parts
93
154
 
94
- | Part | Element | Description |
155
+ | Part key | Element | Description |
95
156
  |---|---|---|
96
- | `wrapper` | `<button>` root | The outermost button element |
97
- | `text` | Typography | The text label |
98
-
99
- ### CSS Custom Properties
157
+ | `button` | `<button>` | Outermost button element |
158
+ | `contentWrapper` | Inner `<Flex>` | Wraps icon + text content |
159
+ | `text` | `<Typography>` | Text label |
160
+ | `icon` | `<Icon>` | Icon element |
161
+ | `loader` | `<Flex>` | Loader wrapper |
162
+ | `success` | `<Flex>` | Success tick wrapper |
100
163
 
101
- The `.varClass` block in `Button.module.css` defines local custom properties that size variants override:
164
+ Pass class overrides via `customClass`, extra props via `customProps`, or arbitrary HTML attributes via `customAttributes`.
102
165
 
103
- | Property | Default | Description |
104
- |---|---|---|
105
- | `--local-Button-radius` | `4px` | Border radius |
106
- | `--local-Button-gap` | `8px` | Content gap |
107
- | `--local-Button-padding-block` | `6px` | Block padding |
108
- | `--local-Button-padding-inline` | `15px` | Inline padding |
109
- | `--local-Button-min-width` | `90px` | Minimum width |
110
- | `--local-Button-spinner-size` | `16px` | Spinner/tick size |
166
+ ```jsx
167
+ <Button
168
+ customClass={{ wrapper: 'myBtn', text: 'myBtnText' }}
169
+ customAttributes={{ button: { 'data-analytics': 'save' } }}
170
+ a11yAttributes={{ 'aria-label': 'Save document' }}
171
+ >
172
+ Save
173
+ </Button>
174
+ ```