@react-fabric/core 1.0.0-beta.5 → 1.0.0-beta.52

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

@@ -10,17 +10,38 @@ var useEffectDebugger = require('../../hooks/useEffectDebugger.js');
 var HotKey = require('../../hotkeys/HotKey.js');
 var HotKeyLabel = require('../../hotkeys/HotKeyLabel.js');
 var Tooltip = require('../../overlays/tooltip/Tooltip.js');
+var jsxRuntime = require('react/jsx-runtime');
+var getColor = require('../../utils/getColor.js');
 var Animations = require('../animations/Animations.js');
 var Badge = require('../badge/Badge.js');
 var Icon = require('../icon/Icon.js');
-var Button_module = require('./Button.module.css');
-var jsxRuntime = require('react/jsx-runtime');
 
 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"];
 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,
@@ -67,6 +88,8 @@ var Button = function Button(_ref) {
     _useState4 = _slicedToArray(_useState3, 2),
     actionDone = _useState4[0],
     setActionDone = _useState4[1];
+
+  // Handle click events
   var clickHandler = react.useCallback(function (e) {
     setBusy(true);
     stopPropagation && e.stopPropagation();
@@ -101,7 +124,7 @@ var Button = function Button(_ref) {
       return {
         content: actionMessage,
         placement: "top",
-        color: color,
+        color: "".concat(color, "-100"),
         open: true
       };
     }
@@ -109,24 +132,25 @@ var Button = function Button(_ref) {
   var badgeProps = react.useMemo(function () {
     return Badge.getBadgeProps(badge);
   }, [badge]);
+  var hotKeyHandler = react.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__*/jsxRuntime.jsxs("div", {
-    className: classNames(Button_module.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__*/jsxRuntime.jsx(HotKey.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__*/jsxRuntime.jsx(TooltipWrapper, _objectSpread(_objectSpread({}, tooltipProps), {}, {
       children: /*#__PURE__*/jsxRuntime.jsxs(E, _objectSpread(_objectSpread({
         ref: utilities.mergeRefs(ref, refEl),
         role: "button",
-        className: classNames(Button_module.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 && Button_module.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,
@@ -137,29 +161,32 @@ var Button = function Button(_ref) {
         "data-variant": variant
       }, aria), {}, {
         children: [icon && /*#__PURE__*/jsxRuntime.jsx(Icon.Icon, {
-          className: Button_module.buttonIcon,
+          className: "fabric-buttonIcon",
           icon: icon,
           bg: iconBg,
           color: iconColor,
           rtlFlip: rtlFlip,
           "data-align": iconAlign
         }), /*#__PURE__*/react.isValidElement(children) && /*#__PURE__*/jsxRuntime.jsx("div", {
-          className: Button_module.buttonChild,
+          className: "fabric-buttonChild",
           children: children
         }), utilities.isString(children) && /*#__PURE__*/jsxRuntime.jsx("label", {
-          className: classNames(Button_module.buttonLabel, "truncate"),
+          className: classNames("fabric-buttonLabel", "truncate"),
           "data-colored-icon": !!iconBg,
           children: children
         }), !utilities.isNil(badge) && /*#__PURE__*/jsxRuntime.jsx(Badge.Badge, _objectSpread({}, badgeProps)), hotKey && /*#__PURE__*/jsxRuntime.jsx(HotKeyLabel.HotKeyLabel, {
           keyCombo: hotKey
         }), altIcon && /*#__PURE__*/jsxRuntime.jsx(Icon.Icon, {
-          className: Button_module.altIcon,
+          className: "fabric-altIcon",
           icon: altIcon,
           rtlFlip: true
         })]
       }))
     })), actionDone && /*#__PURE__*/jsxRuntime.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.getColor("".concat(color, "-300"))
+      },
       children: /*#__PURE__*/jsxRuntime.jsx(Animations.AnimationIndicator, {
         type: "check",
         color: color

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

@@ -4,12 +4,39 @@ var _defineProperty = require('@babel/runtime/helpers/defineProperty');
 var _objectWithoutProperties = require('@babel/runtime/helpers/objectWithoutProperties');
 var classNames = require('classnames');
 var react = require('react');
-var Button_module = require('./Button.module.css');
+var cloneElement = require('../../utils/cloneElement.js');
+require('@react-fabric/utilities');
 var jsxRuntime = require('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__*/jsxRuntime.jsx("div", _objectSpread(_objectSpread({
     "data-ref": "buttonGroup",
-    className: classNames(Button_module.buttonGroup, className, fullWidth ? "flex" : "inline-flex", "flex-nowrap align-middle rounded", vertical && Button_module.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: react.Children.map(children, function (child) {
+    children: cloneElement.cloneChildren(children, function (child) {
       return /*#__PURE__*/react.cloneElement(child, _objectSpread({
         color: color,
         size: size,

package/dist/cjs/components/button/ConfirmButton.js

@@ -11,12 +11,33 @@ var reactI18next = require('react-i18next');
 var Button = require('./Button.js');
 var jsxRuntime = require('react/jsx-runtime');
 
-var _excluded = ["ref", "message", "color", "okLabel", "cancelLabel", "onClick", "loading", "actionMessage", "showActionDone", "showActionDoneEvent"],
+var _excluded = ["ref", "message", "color", "okLabel", "cancelLabel", "onClick", "loading", "placement", "actionMessage", "showActionDone", "showActionDoneEvent"],
   _excluded2 = ["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; }
 /**
- * Button with confirmation dropdown
+ * A button that shows a confirmation dialog when clicked, allowing the user to confirm or cancel an action.
+ * It supports custom messages, labels, and loading states.
+ * This component is useful for actions that require user confirmation, such as deleting items or submitting forms.
+ * It uses the Floating UI library to manage the positioning of the confirmation dialog, ensuring it appears correctly relative to the button.
+ * It also supports custom placement of the dialog, and can display an action message when the action is completed.
+ *
+ * @param {ConfirmButtonProps} props - The properties for the ConfirmButton component.
+ * @returns {JSX.Element} The rendered ConfirmButton component.
+ *
+ * @example
+ * ```jsx
+ * <ConfirmButton
+ *   message="Are you sure you want to delete this item?"
+ *   onClick={(confirmed) => {
+ *     if (confirmed) {
+ *       // Perform action
+ *     }
+ *   }}
+ * />
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/core-components-confirmbutton--docs} for more details.
  */
 var ConfirmButton = function ConfirmButton(_ref) {
   var ref = _ref.ref,
@@ -26,6 +47,8 @@ var ConfirmButton = function ConfirmButton(_ref) {
     cancelLabel = _ref.cancelLabel,
     onClick = _ref.onClick,
     loading = _ref.loading,
+    _ref$placement = _ref.placement,
+    placement = _ref$placement === void 0 ? "bottom" : _ref$placement,
     actionMessage = _ref.actionMessage,
     showActionDone = _ref.showActionDone,
     _ref$showActionDoneEv = _ref.showActionDoneEvent,
@@ -77,7 +100,7 @@ var ConfirmButton = function ConfirmButton(_ref) {
         }
       },
       strategy: "fixed",
-      placement: "bottom",
+      placement: placement,
       whileElementsMounted: react$1.autoUpdate,
       middleware: [react$1.shift({
         padding: 8
@@ -123,18 +146,22 @@ var ConfirmButton = function ConfirmButton(_ref) {
           "data-color": color,
           className: classNames("select-none not-italic rounded-capped shadow-lg outline outline-muted bg-base"),
           ref: refs.setFloating,
-          style: floatingStyles
+          style: _objectSpread({
+            zIndex: "var(--z-popover)"
+          }, floatingStyles)
         }, getFloatingProps()), {}, {
           children: [/*#__PURE__*/jsxRuntime.jsxs("div", {
             className: "font-medium ",
             children: [/*#__PURE__*/jsxRuntime.jsx("p", {
               className: "py-2 px-4",
+              "data-ref": "confirmMessage",
               children: message
             }), /*#__PURE__*/jsxRuntime.jsxs("div", {
               className: "flex justify-end py-2 px-4 gap-2",
               children: [/*#__PURE__*/jsxRuntime.jsx(Button.Button, {
                 size: "sm",
                 variant: "link",
+                "data-ref": "confirmCancel",
                 color: color,
                 onClick: function onClick() {
                   return [clickHandler(false), setIsOpen(false)];
@@ -145,6 +172,7 @@ var ConfirmButton = function ConfirmButton(_ref) {
                 variant: "solid",
                 color: color,
                 autoFocus: true,
+                "data-ref": "confirmOk",
                 onClick: function onClick() {
                   return [clickHandler(true), setIsOpen(false)];
                 },

package/dist/cjs/components/button/ToggleButtonGroup.js

@@ -7,12 +7,40 @@ var utilities = require('@react-fabric/utilities');
 var classNames = require('classnames');
 var react = require('react');
 var useControlledValue = require('../../hooks/useControlledValue.js');
-var Button_module = require('./Button.module.css');
+var cloneElement = require('../../utils/cloneElement.js');
 var jsxRuntime = require('react/jsx-runtime');
 
 var _excluded = ["vertical", "className", "children", "variant", "rounded", "disabled", "fullWidth", "color", "size", "value", "onChange"];
 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 toggle buttons together, allowing for consistent styling and behavior across multiple toggle buttons.
+ * It supports vertical orientation, various button styles, and can handle properties like size, color, and disabled state.
+ * This component is useful for creating toggle button groups that maintain a uniform appearance and functionality,
+ * such as toggle switches, selection groups, or multi-select options.
+ *
+ * @param {ToggleButtonGroupProps} props - The properties for the ToggleButtonGroup component.
+ * @returns {JSX.Element} The rendered ToggleButtonGroup component.
+ *
+ * @example
+ * ```jsx
+ * <ToggleButtonGroup
+ *   value={selectedValues}
+ *   onChange={(newValues) => setSelectedValues(newValues)}
+ *   variant="outline"
+ *   color="primary"
+ *   size="md"
+ *   rounded
+ *   fullWidth
+ * >
+ *   <Button value="option1">Option 1</Button>
+ *   <Button value="option2">Option 2</Button>
+ *   <Button value="option3">Option 3</Button>
+ * </ToggleButtonGroup>
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/core-components-togglebuttongroup--docs} for more details.
+ */
 var ToggleButtonGroup = function ToggleButtonGroup(_ref) {
   var vertical = _ref.vertical,
     className = _ref.className,
@@ -26,19 +54,18 @@ var ToggleButtonGroup = function ToggleButtonGroup(_ref) {
     value = _ref.value,
     onChange = _ref.onChange,
     aria = _objectWithoutProperties(_ref, _excluded);
-  var isMultiple = react.useMemo(function () {
-    return utilities.isArray(value);
-  }, [value]);
-  var _useControlledValue = useControlledValue.useControlledValue(value, utilities.isArray(value) ? utilities.EMPTY_ARRAY : ""),
+  var _useControlledValue = useControlledValue.useControlledValue(value, utilities.isArray(value) ? utilities.EMPTY_ARRAY : null),
     currentValue = _useControlledValue.currentValue,
     updateValue = _useControlledValue.updateValue;
-  var clickHandler = react.useCallback(function (cb) {
+  var clickHandler = react.useCallback(function (cb, childValue) {
     return function (e) {
-      var newValue = "".concat(e.currentTarget.dataset.value);
+      var newValue;
       if (utilities.isArray(currentValue)) {
-        if (currentValue.includes(newValue)) newValue = currentValue.filter(function (v) {
-          return v !== newValue;
-        });else newValue = [].concat(_toConsumableArray(currentValue), [newValue]);
+        if (currentValue.includes(childValue)) newValue = currentValue.filter(function (v) {
+          return v !== childValue;
+        });else newValue = [].concat(_toConsumableArray(currentValue), [childValue]);
+      } else {
+        newValue = childValue;
       }
       updateValue(newValue);
       onChange === null || onChange === void 0 || onChange(newValue);
@@ -46,9 +73,9 @@ var ToggleButtonGroup = function ToggleButtonGroup(_ref) {
     };
   }, [currentValue, onChange]);
   return /*#__PURE__*/jsxRuntime.jsx("div", _objectSpread(_objectSpread({
-    className: classNames(Button_module.buttonGroup, className, fullWidth ? "flex" : "inline-flex", "flex-nowrap align-middle", vertical && Button_module.vertical, vertical && "flex-col")
+    className: classNames("fabric-buttonGroup", className, fullWidth ? "flex" : "inline-flex", "flex-nowrap align-middle", vertical && "vertical", vertical && "flex-col")
   }, aria), {}, {
-    children: react.Children.map(children, function (child) {
+    children: cloneElement.cloneChildren(children, function (child) {
       return /*#__PURE__*/react.cloneElement(child, _objectSpread(_objectSpread({
         color: color,
         size: size,
@@ -57,9 +84,8 @@ var ToggleButtonGroup = function ToggleButtonGroup(_ref) {
         rounded: rounded,
         fullWidth: fullWidth
       }, child.props), {}, {
-        onClick: clickHandler(child.props.onClick),
-        "data-value": child.props.value,
-        "data-checked": isMultiple ? currentValue.includes(child.props.value) : currentValue === child.props.value
+        onClick: clickHandler(child.props.onClick, child.props.value),
+        "data-checked": utilities.isArray(currentValue) ? currentValue === null || currentValue === void 0 ? void 0 : currentValue.includes(child.props.value) : currentValue === child.props.value
       }));
     })
   }));

package/dist/cjs/components/callout/Callout.js

@@ -4,14 +4,50 @@ var _defineProperty = require('@babel/runtime/helpers/defineProperty');
 var _objectWithoutProperties = require('@babel/runtime/helpers/objectWithoutProperties');
 var classNames = require('classnames');
 var icons = require('../../types/icons.js');
-var getColor = require('../../utils/getColor.js');
-require('@react-fabric/utilities');
 var Icon = require('../icon/Icon.js');
 var jsxRuntime = require('react/jsx-runtime');
 
 var _excluded = ["children", "color", "legend", "title", "icon", "border", "onClose", "className"];
 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; }
+// colors for different callout types
+var colors = {
+  none: "bg-base text-tint-900 border-tint-100",
+  tint: "bg-tint-50/50 text-tint-800 border-tint-300",
+  primary: "bg-primary-50/50 text-primary-800 border-primary-300",
+  accent: "bg-accent-50/50 text-accent-800 border-accent-300",
+  info: "bg-info-50/50 text-info-800 border-info-300",
+  danger: "bg-danger-50/50 text-danger-800 border-danger-300",
+  success: "bg-success-50/50 text-success-800 border-success-300",
+  warning: "bg-warning-50/50 text-warning-800 border-warning-300"
+};
+
+/**
+ * A component that displays a callout box with an optional title, icon, and legend.
+ * It can be used to highlight important information, warnings, or notices.
+ * The callout can be styled with different colors and border styles, and it supports a close action.
+ * This component is useful for drawing attention to specific content within a page or application,
+ * such as alerts, notifications, or important messages.
+ *
+ * @param {CalloutProps} props - The properties for the Callout component.
+ * @returns {JSX.Element} The rendered Callout component.
+ *
+ * @example
+ * ```jsx
+ * <Callout
+ *   color="primary"
+ *   legend="Important Notice"
+ *   title="Attention Required"
+ *   icon="info"
+ *   onClose={() => console.log("Callout closed")}
+ * >
+ *   This is an important message that requires your attention.
+ * </Callout>
+ * // Renders a callout box with a primary color, an icon, a title, and a close button.
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/story/core-components-callout--docs} for more details.
+ */
 var Callout = function Callout(_ref) {
   var children = _ref.children,
     _ref$color = _ref.color,
@@ -24,19 +60,22 @@ var Callout = function Callout(_ref) {
     className = _ref.className,
     aria = _objectWithoutProperties(_ref, _excluded);
   return /*#__PURE__*/jsxRuntime.jsxs("fieldset", _objectSpread(_objectSpread({
-    className: classNames(className, "block rounded-capped border max-w-full relative overflow-hidden mb-4", getColor.getBgClass(color + "-50"), getColor.getColorClass(color + "-700"), getColor.getBorderClass(color + "-300"), border === "dashed" && "border-dashed", border === "dotted" && "border-dotted")
+    className: classNames("block rounded-capped border max-w-full relative overflow-hidden mb-4", colors[color], className, border === "dashed" && "border-dashed", border === "dotted" && "border-dotted")
   }, aria), {}, {
     children: [legend && /*#__PURE__*/jsxRuntime.jsx("legend", {
       className: "px-2 mx-4 font-medium",
+      "data-ref": "calloutLegend",
       children: legend
     }), /*#__PURE__*/jsxRuntime.jsxs("div", {
       className: classNames("break-words whitespace-break-spaces p-2"),
       children: [/*#__PURE__*/jsxRuntime.jsxs("div", {
         className: "flex flex-nowrap items-center text-xl pe-4 gap-2 mb-4 empty:mb-0",
         children: [icon && /*#__PURE__*/jsxRuntime.jsx(Icon.Icon, {
-          icon: icon
+          icon: icon,
+          "data-ref": "calloutIcon"
         }), title && /*#__PURE__*/jsxRuntime.jsx("p", {
           className: "flex-1",
+          "data-ref": "calloutTitle",
           children: title
         })]
       }), /*#__PURE__*/jsxRuntime.jsx("div", {
@@ -45,6 +84,7 @@ var Callout = function Callout(_ref) {
       })]
     }), onClose && /*#__PURE__*/jsxRuntime.jsx(Icon.Icon, {
       size: "md",
+      "data-ref": "calloutClose",
       className: classNames("absolute end-2", legend ? "top-0" : "top-2"),
       icon: icons.CoreIcons.close,
       onClick: onClose

package/dist/cjs/components/card/Card.js

@@ -7,14 +7,47 @@ var classNames = require('classnames');
 var react = require('react');
 var ErrorBoundary = require('../../core/boundary/ErrorBoundary.js');
 var HeadFoot = require('../../core/headfoot/HeadFoot.js');
+var jsxRuntime = require('react/jsx-runtime');
 require('@react-fabric/utilities');
 var nodeCheck = require('../../utils/nodeCheck.js');
-var Card_module = require('./Card.module.css');
-var jsxRuntime = require('react/jsx-runtime');
 
-var _excluded = ["children", "className", "bodyClassName", "selected", "selectedRibbon", "onClick", "flex", "draggable", "dragKey", "dragData"];
+var _excluded = ["children", "className", "bodyClassName", "selected", "selectedRibbon", "onClick", "onDragStart", "flex", "draggable", "dragKey", "dragData", "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; }
+/**
+ * A component that displays a card with a header, body, and footer. It can be used to display content in a structured format.
+ * It supports various features such as click handling, drag-and-drop functionality, and customizable styles.
+ * The Card component is designed to be flexible and can be used in various contexts, such as displaying user profiles, product information, or any other content that benefits from a card layout.
+ * The component accepts children that can include a Header, body content, and a Footer.
+ * It also supports additional properties for styling, accessibility, and interaction.
+ * It can be styled with custom CSS classes and supports features like selection indication and drag-and-drop functionality.
+ *
+ * @param {CardProps} props - The properties for the Card component.
+ * @returns {JSX.Element} The rendered Card component.
+ *
+ * @example
+ * ```jsx
+ * <Card
+ *   className="my-custom-class"
+ *   bodyClassName="my-body-class"
+ *   selected={true}
+ *   selectedRibbon={true}
+ *   onClick={() => console.log("Card clicked")}
+ *   onDragStart={(event, key, data) => console.log("Drag started", key, data)}
+ *   flex={true}
+ *   draggable={true}
+ *   dragKey="my-drag-key"
+ *   dragData={{ id: 1, name: "Card Data" }}
+ *   aria-label="My Card"
+ * >
+ *   <Header>Card Header</Header>
+ *   <div>Card Body Content</div>
+ *   <Footer>Card Footer</Footer>
+ * </Card>
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/core-components-card--docs} for more details.
+ */
 var Card = function Card(_ref) {
   var children = _ref.children,
     className = _ref.className,
@@ -22,10 +55,12 @@ var Card = function Card(_ref) {
     selected = _ref.selected,
     selectedRibbon = _ref.selectedRibbon,
     onClick = _ref.onClick,
+    onDragStart = _ref.onDragStart,
     flex = _ref.flex,
     draggable = _ref.draggable,
     dragKey = _ref.dragKey,
     dragData = _ref.dragData,
+    ref = _ref.ref,
     aria = _objectWithoutProperties(_ref, _excluded);
   var _useMemo = react.useMemo(function () {
       return react.Children.toArray(children).reduce(function (ret, node) {
@@ -37,20 +72,23 @@ var Card = function Card(_ref) {
     header = _useMemo2[0],
     body = _useMemo2[1],
     footer = _useMemo2[2];
+  var handleDragStart = react.useCallback(function (event) {
+    var _event$dataTransfer;
+    dragKey && ((_event$dataTransfer = event.dataTransfer) === null || _event$dataTransfer === void 0 ? void 0 : _event$dataTransfer.setData(dragKey, JSON.stringify(dragData)));
+    dragKey && (onDragStart === null || onDragStart === void 0 ? void 0 : onDragStart(event, dragKey, dragData));
+  }, [onDragStart, dragKey, dragData]);
   return /*#__PURE__*/jsxRuntime.jsx("div", {
-    className: classNames(Card_module.cardWrapper, "rounded-capped relative grid", flex && "flex-1", selected && selectedRibbon && Card_module.selected, selected && "outline outline-2 outline-accent-500 outline-offset-2"),
+    className: classNames("fabric-cardWrapper", "rounded-capped relative grid", flex && "flex-1", selected && selectedRibbon && "selected", selected && "outline-2 outline-accent-500 outline-offset-2"),
     children: /*#__PURE__*/jsxRuntime.jsx(ErrorBoundary.ErrorBoundary, {
       children: /*#__PURE__*/jsxRuntime.jsxs("div", _objectSpread(_objectSpread({
-        className: classNames(Card_module.card, className, "rounded-capped flex flex-col flex-nowrap overflow-hidden", onClick && Card_module.clickable),
+        className: classNames("fabric-card", className, "rounded-capped flex flex-col flex-nowrap overflow-hidden", onClick && "clickable"),
         draggable: draggable,
-        onDragStart: !draggable ? undefined : function (e) {
-          var _e$dataTransfer;
-          return dragKey && ((_e$dataTransfer = e.dataTransfer) === null || _e$dataTransfer === void 0 ? void 0 : _e$dataTransfer.setData(dragKey, JSON.stringify(dragData)));
-        }
+        onDragStart: !draggable ? undefined : handleDragStart,
+        ref: ref
       }, aria), {}, {
         children: [header, /*#__PURE__*/jsxRuntime.jsx("div", {
           role: "none",
-          className: classNames(Card_module.cardBody, bodyClassName, "flex-1"),
+          className: classNames("fabric-cardBody", bodyClassName, "flex-1"),
           onClick: onClick,
           children: body
         }), footer]

package/dist/cjs/components/card/CardCover.js

@@ -5,15 +5,45 @@ var _slicedToArray = require('@babel/runtime/helpers/slicedToArray');
 var _objectWithoutProperties = require('@babel/runtime/helpers/objectWithoutProperties');
 var classNames = require('classnames');
 var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
 require('@react-fabric/utilities');
 var nodeCheck = require('../../utils/nodeCheck.js');
 var Media = require('../media/Media.js');
-var Card_module = require('./Card.module.css');
-var jsxRuntime = require('react/jsx-runtime');
 
 var _excluded = ["className", "children", "height", "justify", "colorScheme"];
 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 scheme = {
+  inheritScheme: "inheritScheme",
+  light: "light",
+  dark: "dark"
+};
+
+/**
+ * A cover component for cards that can contain media and content.
+ * It allows for flexible layout options and supports different color schemes.
+ * It can be used to create visually appealing card layouts with media content.
+ *
+ * @param {CardCoverProps} props - The properties for the CardCover component.
+ * @returns {JSX.Element} The rendered CardCover component.
+ *
+ * @example
+ * ```jsx
+ * <CardCover
+ *   height={200}
+ *   colorScheme="light"
+ *   justify="center"
+ *   className="my-custom-class"
+ *   aria-label="Card Cover"
+ * >
+ *   <Image src="image.jpg" alt="Card Image" />
+ *   <div>Card Content</div>
+ * </CardCover>
+ * // Renders a card cover with a height of 200px, light color scheme, centered content, and a custom class name.
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/story/core-components-card--docs} for more details.
+ */
 var CardCover = function CardCover(_ref) {
   var className = _ref.className,
     children = _ref.children,
@@ -21,7 +51,8 @@ var CardCover = function CardCover(_ref) {
     height = _ref$height === void 0 ? 120 : _ref$height,
     _ref$justify = _ref.justify,
     justify = _ref$justify === void 0 ? "end" : _ref$justify,
-    colorScheme = _ref.colorScheme,
+    _ref$colorScheme = _ref.colorScheme,
+    colorScheme = _ref$colorScheme === void 0 ? "inheritScheme" : _ref$colorScheme,
     aria = _objectWithoutProperties(_ref, _excluded);
   var _useMemo = react.useMemo(function () {
       return react.Children.toArray(children).reduce(function (ret, node) {
@@ -36,10 +67,10 @@ var CardCover = function CardCover(_ref) {
     style: {
       height: height
     },
-    className: classNames(Card_module.cardCover, Card_module[colorScheme !== null && colorScheme !== void 0 ? colorScheme : "inheritScheme"], "relative z-0")
+    className: classNames("fabric-cardCover", scheme[colorScheme], "relative z-0")
   }, aria), {}, {
     children: [media, /*#__PURE__*/jsxRuntime.jsx("div", {
-      className: classNames(Card_module.cardCoverContent, "relative pointer-events-none z-1 flex flex-col flex-nowrap p-4 h-full", className, "justify-".concat(justify), className),
+      className: classNames("fabric-cardCoverContent", "relative pointer-events-none z-1 flex flex-col flex-nowrap p-4 h-full", "justify-".concat(justify), className),
       children: body
     })]
   }));