@react-fabric/core 1.0.0-beta.6 → 1.0.0-beta.60

package/dist/esm/components/avatar/Avatar.js

@@ -7,11 +7,10 @@ import { isSvgPath } from '@react-fabric/utilities';
 import BoringAvatar from 'boring-avatars';
 import classNames from 'classnames';
 import { useState, useMemo } from 'react';
-import { getColor, getBgClass, getColorClass } from '../../utils/getColor.js';
-import classes from './Avatar.module.css';
 import { jsxs, jsx } from 'react/jsx-runtime';
+import { getColor } from '../../utils/getColor.js';
 
-var _excluded = ["ref", "name", "avatar", "fallbackIcon", "bg", "color", "size", "rounded", "variant", "className", "viewBox", "onClick"];
+var _excluded = ["ref", "name", "avatar", "fallbackIcon", "bg", "color", "size", "rounded", "variant", "className", "viewBox", "preventDefault", "onClick"];
 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; }
 var SizeMap = {
@@ -23,7 +22,32 @@ var SizeMap = {
 };
 
 /**
- * An avatar is a graphical representation of a user's identity.
+ * A component that displays an avatar image or a fallback icon with customizable styles and properties.
+ * It supports various avatar types, including text-based avatars, and allows for customization of background color, icon color, size, and rounded corners.
+ * This component is useful for displaying user avatars in applications, providing a visual representation of users or entities.
+ * It can also handle cases where the avatar image fails to load by displaying a fallback icon or text.
+ * It uses the Boring Avatars library for generating fallback avatars based on the user's name.
+ *
+ * @param {AvatarProps} props - The properties for the Avatar component.
+ * @returns {JSX.Element} The rendered Avatar component.
+ *
+ * @example
+ * ```jsx
+ * <Avatar
+ *   name="John Doe"
+ *   avatar="https://example.com/avatar.jpg"
+ *   fallbackIcon="fas fa-user"
+ *   bg="bg-blue-500"
+ *   color="text-white"
+ *   size="md"
+ *   rounded
+ *   variant="beam"
+ *   onClick={() => console.log("Avatar clicked")}
+ * />
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/story/core-components-avatar--docs} for more details.
+ * @see {@link https://boringavatars.com/} for more information on Boring Avatars.
  */
 var Avatar = function Avatar(_ref) {
   var ref = _ref.ref,
@@ -40,14 +64,16 @@ var Avatar = function Avatar(_ref) {
     className = _ref.className,
     _ref$viewBox = _ref.viewBox,
     viewBox = _ref$viewBox === void 0 ? "0 0 24 24" : _ref$viewBox,
-    onClick = _ref.onClick,
+    preventDefault = _ref.preventDefault,
+    _onClick = _ref.onClick,
     aria = _objectWithoutProperties(_ref, _excluded);
   var _useState = useState(true),
     _useState2 = _slicedToArray(_useState, 2),
     fallback = _useState2[0],
     setFallback = _useState2[1];
 
-  /** ***************** style map *******************/
+  // Memoize styles to avoid unnecessary recalculations
+  // and to ensure styles are only recalculated when dependencies change
   var styles = useMemo(function () {
     var s = {};
     if (bg) {
@@ -65,13 +91,14 @@ var Avatar = function Avatar(_ref) {
     return s;
   }, [bg, color, size]);
 
-  /** ***************** render icon *******************/
+  // avatar image
+  // if avatar is not provided, fallback to icon or text
   var avatarImage = useMemo(function () {
     setFallback(!avatar);
     return avatar && /*#__PURE__*/jsxs("div", {
       className: "contents",
       children: [/*#__PURE__*/jsx("div", {
-        className: classNames(classes.imgPlaceholder, "absolute inset-0 bg-gray animate-pulse")
+        className: classNames("fabric-imgPlaceholder", "absolute inset-0 bg-gray animate-pulse")
       }), /*#__PURE__*/jsx("img", {
         src: avatar,
         alt: avatar,
@@ -86,10 +113,13 @@ var Avatar = function Avatar(_ref) {
       })]
     });
   }, [avatar]);
+
+  // render fallback icon or text
   var fallbackAvatar = useMemo(function () {
     if (fallbackIcon) {
       return isSvgPath(fallbackIcon) ? /*#__PURE__*/jsx("svg", {
         viewBox: viewBox,
+        className: "p-[0.125em]",
         children: /*#__PURE__*/jsx("path", {
           fill: "currentColor",
           d: fallbackIcon.toString()
@@ -99,8 +129,7 @@ var Avatar = function Avatar(_ref) {
       });
     }
     if (variant === "text") {
-      var _name$match;
-      var _ref2 = (_name$match = name.match(/(?=(\w).* (\w).*)|(?=(\w\w).*)/)) !== null && _name$match !== void 0 ? _name$match : [],
+      var _ref2 = name.match(/(?=(\w).* (\w).*)|(?=(\w\w).*)/),
         _ref3 = _slicedToArray(_ref2, 4),
         first = _ref3[1],
         second = _ref3[2],
@@ -121,6 +150,7 @@ var Avatar = function Avatar(_ref) {
         })
       });
     }
+    // Fallback to BoringAvatar
     return /*#__PURE__*/jsx(BoringAvatar, {
       square: true,
       size: 64,
@@ -130,10 +160,13 @@ var Avatar = function Avatar(_ref) {
   }, [name, variant, fallbackIcon]);
   return /*#__PURE__*/jsxs("dfn", _objectSpread(_objectSpread({
     role: "presentation",
-    className: classNames(classes.avatar, className, "select-none relative overflow-hidden inline-block box-content leading-none not-italic text-center", bg && getBgClass(bg), color && getColorClass(color), !rounded && "rounded", rounded && "rounded-full"),
-    onClick: onClick,
+    className: classNames("fabric-avatar", className, "select-none relative overflow-hidden inline-block box-content leading-none not-italic text-center", !rounded && "rounded", rounded && "rounded-full"),
+    onClick: function onClick(e) {
+      preventDefault && e.preventDefault();
+      _onClick === null || _onClick === void 0 || _onClick(e);
+    },
     style: styles,
-    "data-clickable": !!onClick,
+    "data-clickable": !!_onClick,
     ref: ref
   }, aria), {}, {
     children: [!fallback && avatarImage, fallback && fallbackAvatar]

package/dist/esm/components/avatar/AvatarGroup.js

@@ -5,7 +5,6 @@ import _objectWithoutProperties from '@babel/runtime/helpers/objectWithoutProper
 import classNames from 'classnames';
 import { useMemo, Children } from 'react';
 import { useMemoDebugger } from '../../hooks/useEffectDebugger.js';
-import classes from './Avatar.module.css';
 import { jsxs, jsx } from 'react/jsx-runtime';
 
 var _excluded = ["ref", "children", "className", "totalCount", "rounded", "size"];
@@ -20,7 +19,25 @@ var SizeMap = {
 };
 
 /**
- * Group multiple avatars together
+ * A component that groups multiple avatars together, displaying a count of additional avatars if the total exceeds the visible ones.
+ * It allows customization of size, rounding, and additional aria attributes.
+ * This component is useful for displaying a collection of user avatars in a compact format, such as in a chat application or user list.
+ * It automatically calculates the number of additional avatars based on the `totalCount` prop and the number of children provided.
+ *
+ * @param {AvatarGroupProps} props - The properties for the AvatarGroup component.
+ * @returns {JSX.Element} The rendered AvatarGroup component.
+ *
+ * @example
+ * ```jsx
+ * <AvatarGroup totalCount={5} size="md" className="my-avatar-group">
+ *   <Avatar name="John Doe" avatar="https://example.com/avatar1.jpg" />
+ *   <Avatar name="Jane Smith" avatar="https://example.com/avatar2.jpg" />
+ *   <Avatar name="Alice Johnson" avatar="https://example.com/avatar3.jpg" />
+ *   <Avatar name="Bob Brown" avatar="https://example.com/avatar4.jpg" />
+ * </AvatarGroup>
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/core-components-avatar--docs} for more details.
  */
 var AvatarGroup = function AvatarGroup(_ref) {
   var ref = _ref.ref,
@@ -49,10 +66,11 @@ var AvatarGroup = function AvatarGroup(_ref) {
   }, [avatars, totalCount]);
   return /*#__PURE__*/jsxs("div", _objectSpread(_objectSpread({}, aria), {}, {
     ref: ref,
-    className: classNames(classes.avatarGroup, className, "inline-flex flex-nowrap", !rounded && "rounded", rounded && "rounded-full"),
+    className: classNames("fabric-avatarGroup", className, "inline-flex flex-nowrap", !rounded && "rounded", rounded && "rounded-full"),
     style: styles,
     children: [avatars, !!diff && /*#__PURE__*/jsx("dfn", {
-      className: classNames(classes.avatar, "select-none relative overflow-hidden inline-block box-content leading-none not-italic text-center", classes.extra),
+      "data-ref": "avatarCount",
+      className: classNames("fabric-avatar", "select-none relative overflow-hidden inline-block box-content leading-none not-italic text-center", "fabric-avatarGroup--extra"),
       children: /*#__PURE__*/jsx("svg", {
         children: /*#__PURE__*/jsx("text", {
           x: "50%",

package/dist/esm/components/badge/Badge.js

@@ -4,16 +4,22 @@ import _defineProperty from '@babel/runtime/helpers/defineProperty';
 import _objectWithoutProperties from '@babel/runtime/helpers/objectWithoutProperties';
 import { isObject, isNil, isNumber, mergeRefs } from '@react-fabric/utilities';
 import classNames from 'classnames';
-import { useMemo, cloneElement } from 'react';
-import { Icon } from '../icon/Icon.js';
-import classes from './Badge.module.css';
+import { isValidElement, useMemo, cloneElement } from 'react';
+import { Icon, getIconProps } from '../icon/Icon.js';
 import { jsxs, jsx } from 'react/jsx-runtime';
 
-var _excluded = ["ref", "className", "value", "max", "ping", "block", "placement", "children", "forButton", "icon", "iconBg", "iconColor", "rtlFlip"];
+var _excluded = ["ref", "className", "value", "max", "ping", "block", "inline", "placement", "children", "forButton", "icon"];
 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; }
+/**
+ * Utility function to get badge properties from a badge value or object.
+ * It checks if the badge is an object and returns its properties,
+ *
+ * @param {string | number | BadgeType} badge - The badge value or object.
+ * @returns {AnyObject} An object containing badge properties.
+ */
 var getBadgeProps = function getBadgeProps(badge) {
-  if (isObject(badge)) {
+  if (isObject(badge) && ! /*#__PURE__*/isValidElement(badge)) {
     return Object.assign({
       forButton: true,
       placement: ""
@@ -26,6 +32,25 @@ var getBadgeProps = function getBadgeProps(badge) {
     };
   }
 };
+
+/**
+ * A component that displays a badge with a value, icon, and optional ping animation.
+ * It can be used to indicate notifications, messages, or other important information.
+ * It supports various placements, inline or block display, and custom styling.
+ * It can also wrap children elements, allowing for flexible usage in buttons or other components.
+ *
+ * @param {BadgeProps} props - The properties for the Badge component.
+ * @returns {JSX.Element} The rendered Badge component.
+ *
+ * @example
+ * ```jsx
+ * <Badge value={5} max={10} ping>
+ *   <button>Notifications</button>
+ * </Badge>
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/core-components-badge--docs} for more details.
+ */
 var Badge = function Badge(_ref) {
   var ref = _ref.ref,
     className = _ref.className,
@@ -33,17 +58,18 @@ var Badge = function Badge(_ref) {
     max = _ref.max,
     ping = _ref.ping,
     block = _ref.block,
+    inline = _ref.inline,
     _ref$placement = _ref.placement,
     placement = _ref$placement === void 0 ? "top-end" : _ref$placement,
     children = _ref.children,
     _ref$forButton = _ref.forButton,
     forButton = _ref$forButton === void 0 ? false : _ref$forButton,
     icon = _ref.icon,
-    iconBg = _ref.iconBg,
-    iconColor = _ref.iconColor,
-    rtlFlip = _ref.rtlFlip,
     rest = _objectWithoutProperties(_ref, _excluded);
   var label = useMemo(function () {
+    if ( /*#__PURE__*/isValidElement(value)) {
+      return value;
+    }
     if (!isNil(value)) {
       if (isNumber(value) && max && value > max) {
         return "".concat(max, "+");
@@ -59,23 +85,18 @@ var Badge = function Badge(_ref) {
    * wrap children in a relative div to float badge, wrapper allows for floating a badge on elements with overflow hidden
    */
   return /*#__PURE__*/jsxs("div", {
-    className: classNames(forButton ? "contents" : "relative", block ? "block" : "inline-block"),
+    className: classNames(forButton || inline ? "contents" : block ? "block" : "inline-block", forButton || inline ? "" : "relative"),
     children: [children && /*#__PURE__*/cloneElement(children, _objectSpread(_objectSpread({}, rest), {}, {
       ref: innerRef
-    })), (!!ping || label) && /*#__PURE__*/jsxs("div", {
+    })), (!!ping || (label !== null && label !== void 0 ? label : icon)) && /*#__PURE__*/jsxs("div", {
       "data-ref": "badge",
       "data-ping": ping,
       "data-placement": placement,
-      className: classNames(classes.badge, className, "inline-block p-px min-w-2 min-h-2 text-center select-none rounded-full leading-none z-5 pointer-events-none", forButton && !placement ? "relative" : "absolute"),
+      className: classNames("fabric-badge", className, "inline-block p-px min-w-2 min-h-2 text-center select-none rounded-full leading-none z-2 pointer-events-none", forButton && !placement || inline ? "relative flex-content" : "absolute"),
       children: [label && /*#__PURE__*/jsx("span", {
         className: "p-1",
         children: label
-      }), icon && /*#__PURE__*/jsx(Icon, {
-        icon: icon,
-        bg: iconBg,
-        color: iconColor,
-        rtlFlip: rtlFlip
-      })]
+      }), icon && /*#__PURE__*/jsx(Icon, _objectSpread({}, getIconProps(icon)))]
     })]
   });
 };

package/dist/esm/components/breadcrumbs/Breadcrumbs.js

@@ -5,14 +5,42 @@ import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
 import _objectWithoutProperties from '@babel/runtime/helpers/objectWithoutProperties';
 import classNames from 'classnames';
 import { useMemo, Children } from 'react';
-import { Link } from '../../typography/Link.js';
+import { Anchor } from '../../typography/Anchor.js';
 import { Dropdown } from '../dropdown/Dropdown.js';
-import classes from './Breadcrumbs.module.css';
 import { jsxs, jsx } from 'react/jsx-runtime';
 
 var _excluded = ["variant", "className", "separator", "children", "color"];
 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; }
+/**
+ * A navigation component that displays the current page's location within a hierarchy and allows users to navigate back to previous pages.
+ * It supports different styles, separators, and colors, and can handle a variable number of breadcrumb links.
+ * This component is useful for enhancing user navigation experience in applications with multiple levels of content hierarchy.
+ * It automatically manages the display of overflow items when there are too many links to fit in the available space, providing a dropdown for additional links.
+ *
+ * @param {BreadcrumbProps} props - The properties for the Breadcrumbs component.
+ * @returns {JSX.Element} The rendered Breadcrumbs component.
+ *
+ * @example
+ * ```jsx
+ * <Breadcrumbs
+ *   variant="classic"
+ *   separator=">"
+ *   color="primary"
+ *   className="my-custom-class"
+ *   aria-label="Breadcrumbs"
+ * >
+ *   <Anchor href="/">Home</Anchor>
+ *   <Anchor href="/products">Products</Anchor>
+ *   <Anchor href="/products/shoes">Shoes</Anchor>
+ *   <Anchor href="/products/shoes/sneakers">Sneakers</Anchor>
+ *   <Anchor href="/products/shoes/sneakers/nike">Nike</Anchor>
+ *   <Anchor href="/products/shoes/sneakers/nike/airmax">Air Max</Anchor>
+ * </Breadcrumbs>
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/core-components-breadcrumbs--docs} for more details.
+ */
 var Breadcrumbs = function Breadcrumbs(_ref) {
   var _ref$variant = _ref.variant,
     variant = _ref$variant === void 0 ? "classic" : _ref$variant,
@@ -23,7 +51,7 @@ var Breadcrumbs = function Breadcrumbs(_ref) {
     color = _ref.color,
     aria = _objectWithoutProperties(_ref, _excluded);
   var _useMemo = useMemo(function () {
-      var nodeList = Children.toArray(children);
+      var nodeList = Children.toArray(children).filter(Boolean);
       if (nodeList.length > 7) {
         return [nodeList.slice(0, 3), nodeList.slice(3, -3), nodeList.slice(-3)];
       }
@@ -34,13 +62,14 @@ var Breadcrumbs = function Breadcrumbs(_ref) {
     overflow = _useMemo2[1],
     end = _useMemo2[2];
   return /*#__PURE__*/jsxs("nav", _objectSpread(_objectSpread({
+    "data-ref": "breadcrumbs",
     "data-color": color,
     "data-variant": variant,
-    className: classNames(classes.breadcrumbs, className, "flex flex-nowrap items-center")
+    className: classNames("fabric-breadcrumbs", className, "flex flex-nowrap items-center")
   }, aria), {}, {
     children: [start.map(function (link, idx) {
       return /*#__PURE__*/jsx("li", {
-        className: classes.breadcrumbLink,
+        className: "fabric-breadcrumbLink",
         "data-separator": separator,
         children: link
       }, idx);
@@ -48,19 +77,21 @@ var Breadcrumbs = function Breadcrumbs(_ref) {
       closeOnClick: true,
       showArrow: true,
       children: [/*#__PURE__*/jsx("li", {
-        className: classes.breadcrumbLink,
+        className: "fabric-breadcrumbLink",
         "data-separator": separator,
-        children: /*#__PURE__*/jsx(Link, {
+        "data-ref": "breadcrumbOverflow",
+        children: /*#__PURE__*/jsx(Anchor, {
+          "data-": true,
           children: "..."
         })
       }), /*#__PURE__*/jsx("div", {
         "data-color": color,
-        className: classNames(classes.breadcrumbOverflow, "flex flex-col"),
+        className: classNames("fabric-breadcrumbOverflow", "flex flex-col"),
         children: overflow
       })]
     }), end === null || end === void 0 ? void 0 : end.map(function (link, idx) {
       return /*#__PURE__*/jsx("li", {
-        className: classes.breadcrumbLink,
+        className: "fabric-breadcrumbLink",
         "data-separator": separator,
         children: link
       }, idx);

package/dist/esm/components/button/Button.js

@@ -3,24 +3,45 @@
 import _defineProperty from '@babel/runtime/helpers/defineProperty';
 import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
 import _objectWithoutProperties from '@babel/runtime/helpers/objectWithoutProperties';
-import { mergeRefs, isString, isNil } from '@react-fabric/utilities';
+import { mergeRefs, isString, isObject, isNil } from '@react-fabric/utilities';
 import classNames from 'classnames';
 import { useRef, useState, useCallback, useEffect, useMemo, Fragment, isValidElement } from 'react';
 import { useEffectDebugger } from '../../hooks/useEffectDebugger.js';
 import { HotKey } from '../../hotkeys/HotKey.js';
 import { HotKeyLabel } from '../../hotkeys/HotKeyLabel.js';
 import { Tooltip } from '../../overlays/tooltip/Tooltip.js';
+import { jsxs, jsx } from 'react/jsx-runtime';
+import { getColor } from '../../utils/getColor.js';
 import { AnimationIndicator } from '../animations/Animations.js';
 import { getBadgeProps, Badge } from '../badge/Badge.js';
-import { Icon } from '../icon/Icon.js';
-import classes from './Button.module.css';
-import { jsxs, jsx } from 'react/jsx-runtime';
+import { Icon, getIconProps } from '../icon/Icon.js';
 
-var _excluded = ["as", "ref", "children", "className", "active", "color", "icon", "iconBg", "iconColor", "iconAlign", "altIcon", "rtlFlip", "rounded", "size", "disabled", "loading", "variant", "badge", "fullWidth", "spinOnHover", "onClick", "actionMessage", "stopPropagation", "type", "hotKey", "showActionDone", "showActionDoneEvent", "tabIndex", "data-ref"];
+var _excluded = ["as", "ref", "children", "className", "active", "color", "icon", "iconAlign", "altIcon", "rounded", "size", "disabled", "loading", "variant", "badge", "fullWidth", "spinOnHover", "onClick", "actionMessage", "preventDefault", "stopPropagation", "type", "hotKey", "showActionDone", "showActionDoneEvent", "tabIndex", "data-ref"];
 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; }
 /**
- * Clickable action button
+ * A versatile button component that supports various styles, icons, and actions.
+ * It can be used as a primary action button, with options for loading states, action messages, and more.
+ * It supports polymorphic rendering, allowing it to be used as different HTML elements (e.g., button, a, div).
+ * It also includes features like after action tooltips, badges, and keyboard shortcuts.
+ *
+ * @param {ButtonProps} props - The properties for the Button component.
+ * @returns {JSX.Element} The rendered Button component.
+ *
+ * @example
+ * ```jsx
+ * <Button
+ *   color="primary"
+ *   size="md"
+ *   variant="solid"
+ *   icon="check"
+ *   onClick={() => console.log("Button clicked!")}
+ * >
+ *   Click Me
+ * </Button>
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/core-components-button--docs} for more details.
  */
 var Button = function Button(_ref) {
   var as = _ref.as,
@@ -31,12 +52,9 @@ var Button = function Button(_ref) {
     _ref$color = _ref.color,
     color = _ref$color === void 0 ? "primary" : _ref$color,
     icon = _ref.icon,
-    iconBg = _ref.iconBg,
-    iconColor = _ref.iconColor,
     _ref$iconAlign = _ref.iconAlign,
     iconAlign = _ref$iconAlign === void 0 ? "start" : _ref$iconAlign,
     altIcon = _ref.altIcon,
-    rtlFlip = _ref.rtlFlip,
     rounded = _ref.rounded,
     size = _ref.size,
     disabled = _ref.disabled,
@@ -47,6 +65,7 @@ var Button = function Button(_ref) {
     spinOnHover = _ref.spinOnHover,
     onClick = _ref.onClick,
     actionMessage = _ref.actionMessage,
+    preventDefault = _ref.preventDefault,
     stopPropagation = _ref.stopPropagation,
     _ref$type = _ref.type,
     type = _ref$type === void 0 ? "button" : _ref$type,
@@ -67,8 +86,11 @@ var Button = function Button(_ref) {
     _useState4 = _slicedToArray(_useState3, 2),
     actionDone = _useState4[0],
     setActionDone = _useState4[1];
+
+  // Handle click events
   var clickHandler = useCallback(function (e) {
     setBusy(true);
+    preventDefault && e.preventDefault();
     stopPropagation && e.stopPropagation();
     var ret = onClick === null || onClick === void 0 ? void 0 : onClick(e);
     void Promise.resolve(ret).then(function (b) {
@@ -77,7 +99,7 @@ var Button = function Button(_ref) {
         setActionDone(true);
       }
     });
-  }, [onClick, disabled, actionMessage, showActionDoneEvent, stopPropagation]);
+  }, [onClick, disabled, preventDefault, actionMessage, showActionDoneEvent, stopPropagation]);
 
   /** ***************** reset done state on timeout *******************/
   useEffect(function () {
@@ -101,7 +123,7 @@ var Button = function Button(_ref) {
       return {
         content: actionMessage,
         placement: "top",
-        color: color,
+        color: "".concat(color, "-100"),
         open: true
       };
     }
@@ -109,24 +131,25 @@ var Button = function Button(_ref) {
   var badgeProps = useMemo(function () {
     return getBadgeProps(badge);
   }, [badge]);
+  var hotKeyHandler = useRef(function () {
+    var _refEl$current;
+    !disabled && ((_refEl$current = refEl.current) === null || _refEl$current === void 0 ? void 0 : _refEl$current.click());
+  });
   var E = as !== null && as !== void 0 ? as : "button";
   return /*#__PURE__*/jsxs("div", {
-    className: classNames(classes.buttonWrapper, className, "relative align-text-top select-none focus-within:z-1", fullWidth ? "block w-full" : "inline-block"),
+    className: classNames("fabric-buttonWrapper", className, "relative align-text-top select-none focus-within:z-1", fullWidth ? "block w-full" : "inline-block"),
     "data-ref": dataRef !== null && dataRef !== void 0 ? dataRef : "button",
     "data-size": size,
     "data-loading": busy || loading,
     "data-disabled": disabled,
     children: [hotKey && /*#__PURE__*/jsx(HotKey, {
       keyCombo: hotKey,
-      handler: function handler() {
-        var _refEl$current;
-        return !disabled && ((_refEl$current = refEl.current) === null || _refEl$current === void 0 ? void 0 : _refEl$current.click());
-      }
+      handler: hotKeyHandler.current
     }), /*#__PURE__*/jsx(TooltipWrapper, _objectSpread(_objectSpread({}, tooltipProps), {}, {
       children: /*#__PURE__*/jsxs(E, _objectSpread(_objectSpread({
         ref: mergeRefs(ref, refEl),
         role: "button",
-        className: classNames(classes.button, "pointer-events-auto cursor-pointer select-none flex flex-nowrap w-full h-full items-center border-0 -outline-offset-1 justify-center max-w-72 p-0 font-sans font-medium appearance-none", "focus-visible:ring-2 focus-visible:ring-offset-2 buttonInner", fullWidth && "max-w-full w-full", rounded && "rounded-full", spinOnHover && classes.spinOnHover),
+        className: classNames("fabric-button", "pointer-events-auto cursor-pointer select-none flex flex-nowrap w-full h-full items-center border-0 -outline-offset-1 justify-center max-w-72 p-0 font-sans font-medium appearance-none", "focus-visible:ring-2 focus-visible:ring-offset-2 buttonInner", fullWidth && "max-w-full w-full", rounded && "rounded-full", spinOnHover && "fabric-spinOnHover"),
         type: type,
         disabled: disabled,
         tabIndex: tabIndex,
@@ -136,30 +159,29 @@ var Button = function Button(_ref) {
         "data-active": active,
         "data-variant": variant
       }, aria), {}, {
-        children: [icon && /*#__PURE__*/jsx(Icon, {
-          className: classes.buttonIcon,
-          icon: icon,
-          bg: iconBg,
-          color: iconColor,
-          rtlFlip: rtlFlip,
+        children: [icon && /*#__PURE__*/jsx(Icon, _objectSpread({
+          className: "fabric-buttonIcon",
           "data-align": iconAlign
-        }), /*#__PURE__*/isValidElement(children) && /*#__PURE__*/jsx("div", {
-          className: classes.buttonChild,
+        }, getIconProps(icon))), /*#__PURE__*/isValidElement(children) && /*#__PURE__*/jsx("div", {
+          className: "fabric-buttonChild",
           children: children
         }), isString(children) && /*#__PURE__*/jsx("label", {
-          className: classNames(classes.buttonLabel, "truncate"),
-          "data-colored-icon": !!iconBg,
+          className: classNames("fabric-buttonLabel", "truncate"),
+          "data-colored-icon": isObject(icon) && "bg" in icon,
           children: children
-        }), !isNil(badge) && /*#__PURE__*/jsx(Badge, _objectSpread({}, badgeProps)), hotKey && /*#__PURE__*/jsx(HotKeyLabel, {
+        }), !isNil(badge) && /*#__PURE__*/jsx(Badge, _objectSpread({}, badgeProps)), hotKey && children && /*#__PURE__*/jsx(HotKeyLabel, {
           keyCombo: hotKey
         }), altIcon && /*#__PURE__*/jsx(Icon, {
-          className: classes.altIcon,
+          className: "fabric-altIcon",
           icon: altIcon,
           rtlFlip: true
         })]
       }))
     })), actionDone && /*#__PURE__*/jsx("div", {
-      className: classNames("absolute inset-0 overflow-hidden flex justify-center items-center", "bg-".concat(color, "-300"), rounded ? "rounded-full" : "rounded"),
+      className: classNames("absolute inset-0 overflow-hidden flex justify-center items-center", rounded ? "rounded-full" : "rounded"),
+      style: {
+        backgroundColor: getColor("".concat(color, "-300"))
+      },
       children: /*#__PURE__*/jsx(AnimationIndicator, {
         type: "check",
         color: color

package/dist/esm/components/button/ButtonGroup.js

@@ -3,13 +3,40 @@
 import _defineProperty from '@babel/runtime/helpers/defineProperty';
 import _objectWithoutProperties from '@babel/runtime/helpers/objectWithoutProperties';
 import classNames from 'classnames';
-import { Children, cloneElement } from 'react';
-import classes from './Button.module.css';
+import { cloneElement } from 'react';
+import { cloneChildren } from '../../utils/cloneElement.js';
+import '@react-fabric/utilities';
 import { jsx } from 'react/jsx-runtime';
 
 var _excluded = ["vertical", "className", "children", "variant", "rounded", "disabled", "fullWidth", "color", "size"];
 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; }
+/**
+ * A component that groups buttons together, allowing for consistent styling and behavior across multiple buttons.
+ * It supports vertical orientation, various button styles, and can handle properties like size, color, and disabled state.
+ * This component is useful for creating button groups that maintain a uniform appearance and functionality,
+ * such as toolbars, action groups, or navigation buttons.
+ *
+ * @param {ButtonGroupProps} props - The properties for the ButtonGroup component.
+ * @returns {JSX.Element} The rendered ButtonGroup component.
+ *
+ * @example
+ * ```jsx
+ * <ButtonGroup
+ *   variant="solid"
+ *   color="primary"
+ *   className="my-custom-class"
+ *   aria-label="Button Group"
+ *   vertical
+ * >
+ *   <Button>Button 1</Button>
+ *   <Button>Button 2</Button>
+ *   <Button>Button 3</Button>
+ * </ButtonGroup>
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/core-components-buttongroup--docs} for more details.
+ */
 var ButtonGroup = function ButtonGroup(_ref) {
   var vertical = _ref.vertical,
     className = _ref.className,
@@ -23,9 +50,9 @@ var ButtonGroup = function ButtonGroup(_ref) {
     aria = _objectWithoutProperties(_ref, _excluded);
   return /*#__PURE__*/jsx("div", _objectSpread(_objectSpread({
     "data-ref": "buttonGroup",
-    className: classNames(classes.buttonGroup, className, fullWidth ? "flex" : "inline-flex", "flex-nowrap align-middle rounded", vertical && classes.vertical, vertical && "flex-col items-stretch")
+    className: classNames("fabric-buttonGroup", className, fullWidth ? "flex" : "inline-flex", "flex-nowrap align-middle rounded", vertical && "vertical", vertical && "flex-col items-stretch")
   }, aria), {}, {
-    children: Children.map(children, function (child) {
+    children: cloneChildren(children, function (child) {
       return /*#__PURE__*/cloneElement(child, _objectSpread({
         color: color,
         size: size,